Submit Revamp Task

Upgrade presentation layouts, colors, and Brand DNA while preserving the original slide content.

Interface Specification

Create an asynchronous slide revamp task. The value for type must be revamp.

POST /tools/tasks

Request Headers

Header	Type	Required	Description
`Authorization`	`String`	Yes	`Bearer <YOUR_API_KEY>` — Your developer API key.
`Content-Type`	`String`	Yes	Must be `multipart/form-data`.

POST Request Body Parameters (Form Data)

Parameter	Type	Required	Description
`spaceId`	`String`	No	Target workspace Space ID.
`files`	`File`	Yes	The presentation files to revamp (PPTX). Supports multiple files.
`type`	`String`	Yes	Task type. Fixed value: `revamp`.
`name`	`String`	No	Task display name, e.g., `"AI Document Revamp Task"`.
`params`	`String (JSON)`	Yes	JSON string containing task parameters. Detailed fields below.

Task Parameters (params)

Inner properties supported inside the params JSON string:

Field	Type	Required	Description
`inputText`	`String`	No	Style instructions, color rules, or theme DNA descriptions to guide the revamp.
`advancedModel`	`Boolean`	No	Use advanced design reasoning AI. Default: `false`.
`fastMode`	`Boolean`	No	Prioritize faster execution speed. Default: `false`.
`notifyURL`	`String`	No	Webhook callback address triggered on task status changes.

Request Headers Authentication

Authorization string required

Bearer token passed as Authorization header:

Body Parameters multipart/form-data

spaceId string

Workspace Space ID.

files file

Upload local presentation to revamp.

No file chosen

type string required

Task type, fixed value: revamp.

name string

AI Task Name.

notifyURL string

Webhook callback URL to receive status notifications.

params json string required

Revamp parameters JSON string.

Query Translation Task Query Revamp Task

curl --location 'https://app.deckflow.com/api/tools/tasks' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --form 'spaceId="space-default"' \ --form 'files=@"/path/to/presentation.pptx"' \ --form 'type="revamp"' \ --form 'name="AI Document Revamp Task"' \ --form 'params="{\"inputText\":\"Change font to Outfit and use green/blue palette\",\"advancedModel\":false,\"fastMode\":false}"'

import requests url = "https://app.deckflow.com/api/tools/tasks" headers = { "Authorization": "Bearer YOUR_API_KEY" } files = [ ("files", ("presentation.pptx", open("presentation.pptx", "rb"), "application/octet-stream")) ] data = { "spaceId": "space-default", "type": "revamp", "name": "AI Document Revamp Task", "params": '{"inputText":"Change font to Outfit and use green/blue palette","advancedModel":false,"fastMode":false}' } response = requests.post(url, headers=headers, files=files, data=data) print(response.json())

{{ "id": "task-uuid-string", "spaceId": "space-default", "name": "AI Document Revamp Task", "type": "revamp", "status": "pending", "preview": null, "createdAt": "2026-06-06T08:52:00.000Z", "updatedAt": "2026-06-06T08:52:00.000Z" }}