Get task results

Retrieves the current status and result of a previously triggered workflow task. Use this endpoint to poll for task completion after triggering a workflow.

GET /v1/unstable/agent/tasks/{taskId}

Get task status

cURL

curl --request GET \
  --url https://api.deepl.com/v1/unstable/agent/tasks/{taskId} \
  --header 'Authorization: <api-key>'

200

in_progress

{
  "status": "InProgress",
  "last_modified_date": "2025-12-04T10:30:00Z",
  "ui_url": "https://agent.deepl.com/static/chat/e333fb65-77eb-4669-ba55-201a5e3cff32",
  "result": {}
}

Authorizations

Authorization · string · header · required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Path Parameters

taskId · string · required

Unique identifier of the task to retrieve

Response

200

application/json

Successfully retrieved task status

status · enum<string> · required

Current status of the task

Available options: Archived, InProgress, Completed, Canceled, Error, FeedbackNeeded

Example:

"Completed"

last_modified_date · string<date-time> · required

Timestamp of when the task was last modified (ISO 8601 format)

Example:

"2025-12-04T10:35:00Z"

result · object · required

Workflow-specific result data (structure varies by workflow type)

Example:

{ "output": "Translated text result" }

ui_url · string | null

URL to view the task in the agentic UI

Example:

"https://agent.deepl.com/static/chat/e333fb65-77eb-4669-ba55-201a5e3cff32"