DeckFlow Logo Developers DeckFlow documentation
Get Started
Developer GuideAPI ReferenceMCPCLI

Merger & Splitter

The Merger & Splitter API specifications and task parameters, supporting merging multiple PPTX files, packing HTML pages into a standalone player, or splitting PPTX presentations.

API Endpoints

Merging and splitting tasks are processed asynchronously. Use the two endpoints below to create and retrieve tasks. Click "Try it" on the right to open the interactive playground.

POST /tools/tasks

Creates an asynchronous merge or split task. Pass the corresponding merger/splitter tool identifier in type.

GET /tools/tasks/:id

Queries the execution status of a merge/split task and retrieves the final output download link via result.url.

Request Headers

Header Type Required Description
Authorization String Yes Bearer <YOUR_API_KEY> — API Key.
Content-Type String Yes (POST) Must be multipart/form-data.

POST Request Body Parameters (Form Data)

Parameter Type Required Description
files File Yes The source files to be processed. Supports uploading multiple files. pptx.join requires at least 2 files.
type String Yes Task type identifier. For example: pptx.join.
params String (JSON) No JSON string of tool-specific parameters. Defaults to empty JSON string "{}".
notifyURL String No Webhook callback URL to receive task status update notifications.

Task Parameter Specifications

PPTX Merger

Merges multiple PPTX files sequentially into a single presentation. Supports .pptx format, with a file size limit of 300 MB per file. The order of file uploads determines the sequence of merged slides. params is an empty object {}.

HTML Player Pack

Packages multiple independent HTML slides into a unified, visually appealing web player environment with built-in navigation controls. Supports .html and .htm formats, with a file size limit of 50 MB per file. The structure of params is as follows:

{
  "contents": [{}, {}],       // array of objects. Required. The length and order must match the uploaded files sequence
  "pageWidth": 1280,          // number. Player canvas width resolution (pixels)
  "pageHeight": 720,          // number. Player canvas height resolution (pixels)
  "title": "Presentation",    // string. Main presentation title shown in player
  "description": "Details",   // string. Subtitle or brief description shown in player
  "brandMarkPosition": "none" // string. Position of the brand logo, defaults to "none"
}

PPTX Splitter

Splits a multi-slide PPTX file into individual, single-slide PPTX presentations. Supports .pptx format, with a file size limit of 300 MB. params is an empty object {} (the output will be a ZIP archive containing all split single-page PPTX files upon completion).