Query Generation Task

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

Interface Specification

Query generation 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 generation task.

Submit Generation Task Submit Translation Task

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": "generation",
  "status": "success",
  "error": null,
  "progress": 100,
  "params": {{
    "inputText": "Write an analysis report on the development trends of the renewable energy industry, highlighting the market shares of solar and wind energy.",
    "enableSearch": true,
    "pageCount": 10
  }},
  "result": {{
    "url": "https://app.deckflow.com/api/tasks/Pt1AtI67yauC/download",
    "format": "pptx",
    "sizeBytes": 2048576
  }},
  "createdAt": "2026-06-06T08:52:00.000Z",
  "updatedAt": "2026-06-06T08:52:15.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."
  }}
}}