Query Revamp Task

Query the execution progress and download URL of a document revamp task.

Interface Specification

Query revamp task execution progress and get the download details from result.url once complete.

GET /tools/tasks/:id

Request Headers

Header	Type	Required	Description
`Authorization`	`String`	Yes	`Bearer <YOUR_API_KEY>` — Your developer API key.

Path Parameters

Parameter	Type	Required	Description
`id`	`String`	Yes	The task ID returned when submitting the revamp task.

Submit Revamp Task File Converter

Request Example

curl -X GET "https://app.deckflow.com/api/tools/tasks/Pt1AtI67yauC" \
  -H "Authorization: Bearer YOUR_API_KEY"

fetch('https://app.deckflow.com/api/tools/tasks/Pt1AtI67yauC', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(res => res.json())
.then(data => console.log(data));

import requests

url = "https://app.deckflow.com/api/tools/tasks/Pt1AtI67yauC"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

{{
  "id": "Pt1AtI67yauC",
  "spaceId": "space-default",
  "type": "revamp",
  "status": "success",
  "error": null,
  "progress": 100,
  "params": {{
    "inputText": "Change font to Outfit and use green/blue palette"
  }},
  "result": {{
    "url": "https://app.deckflow.com/api/tasks/Pt1AtI67yauC/download",
    "format": "pptx",
    "sizeBytes": 2205120
  }},
  "createdAt": "2026-06-06T08:52:00.000Z",
  "updatedAt": "2026-06-06T08:52:25.000Z"
}}

{{
  "error": {{
    "code": "invalid_parameter",
    "message": "The request parameters are invalid or missing."
  }}
}}

{{
  "error": {{
    "code": "unauthorized",
    "message": "Invalid API Key or authorization header."
  }}
}}

{{
  "error": {{
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please slow down and try again later."
  }}
}}