curl --request PATCH \
--url https://api.tela.com/task/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "completed"
}
'{
"id": "8b6d2c9a-1f4e-4c1b-9a1e-3c2d5e6f7a80",
"reference": 42,
"name": "Invoice-2025-001.pdf",
"status": "completed",
"rawInput": {
"application_id": "95cec438-6080-44fe-8275-28b16bd40178",
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf"
}
]
}
}
},
"inputContent": {
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf"
}
]
}
},
"messages": [],
"files": []
},
"outputContent": {
"role": "assistant",
"content": {
"cliente": "Acme Corporation",
"valor": 150000
}
},
"originalOutputContent": {
"role": "assistant",
"content": {
"cliente": "Acme Corp",
"valor": 150000
}
},
"createdBy": "api@company.com",
"approvedBy": "reviewer@company.com",
"approvedAt": "2025-01-15T11:00:00.000Z",
"completionRunId": "b83b1558-de5b-4e45-b517-7bececbdd154",
"workflowRunId": null,
"sourceType": "prompt",
"agentId": null,
"agentRef": null,
"agentSessionId": null,
"promptVersionId": "76065caa-c519-441a-8fe2-cc43e29664ab",
"promptApplicationId": "95cec438-6080-44fe-8275-28b16bd40178",
"workspaceId": "3f55cfd9-4427-4887-a181-d9ad39967802",
"metadata": {
"editedFields": [
{
"path": "cliente",
"author": "reviewer@company.com",
"editedAt": "2025-01-15T11:00:00.000Z",
"previousValue": "Acme Corp"
}
]
},
"tags": [
"priority",
"reviewed"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T11:00:00.000Z",
"deletedAt": null
}Update a task
Updates a task’s name, tags, output, or approves it.
curl --request PATCH \
--url https://api.tela.com/task/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "completed"
}
'{
"id": "8b6d2c9a-1f4e-4c1b-9a1e-3c2d5e6f7a80",
"reference": 42,
"name": "Invoice-2025-001.pdf",
"status": "completed",
"rawInput": {
"application_id": "95cec438-6080-44fe-8275-28b16bd40178",
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf"
}
]
}
}
},
"inputContent": {
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf"
}
]
}
},
"messages": [],
"files": []
},
"outputContent": {
"role": "assistant",
"content": {
"cliente": "Acme Corporation",
"valor": 150000
}
},
"originalOutputContent": {
"role": "assistant",
"content": {
"cliente": "Acme Corp",
"valor": 150000
}
},
"createdBy": "api@company.com",
"approvedBy": "reviewer@company.com",
"approvedAt": "2025-01-15T11:00:00.000Z",
"completionRunId": "b83b1558-de5b-4e45-b517-7bececbdd154",
"workflowRunId": null,
"sourceType": "prompt",
"agentId": null,
"agentRef": null,
"agentSessionId": null,
"promptVersionId": "76065caa-c519-441a-8fe2-cc43e29664ab",
"promptApplicationId": "95cec438-6080-44fe-8275-28b16bd40178",
"workspaceId": "3f55cfd9-4427-4887-a181-d9ad39967802",
"metadata": {
"editedFields": [
{
"path": "cliente",
"author": "reviewer@company.com",
"editedAt": "2025-01-15T11:00:00.000Z",
"previousValue": "Acme Corp"
}
]
},
"tags": [
"priority",
"reviewed"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T11:00:00.000Z",
"deletedAt": null
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Only completed is accepted; it approves the task on behalf of the caller.
completed Output changes, e.g. { "content": { "field": "new value" } }. Deep-merged into the existing output for Workstation/App tasks; replaces it for agent tasks.
Replaces the task's tags (trimmed, de-duplicated).
Response
The updated task
Task lifecycle status. created (agent tasks awaiting execution) → running → validating (output ready, awaiting review) → completed (approved). failed and cancelled are terminal.
created, running, validating, completed, failed, cancelled Email of the identity that created the task.
Whether the task belongs to a Workstation/App (prompt) or to an agent (agent).
prompt, agent Sequential number of the task within its app/agent. Assigned shortly after creation.
The completion request the task is executed with. Same shape as the /v2/chat/completions body; application_id is set by the server from promptApplicationId.
Show child attributes
Show child attributes
Normalized input of the execution. null until the run has been prepared.
Show child attributes
Show child attributes
Current output. For Canvas tasks this is the assistant message (role, content, …) where content holds the extracted fields; for workflow tasks it wraps { response, stepOutputs, error? }. Reflects reviewer edits.
Output as originally produced by the execution, before any reviewer edits.
Published agent identifier (agent tasks only).
Canvas version the task was executed with (Workstation/App tasks only).
Show child attributes
Show child attributes
Only present on GET /task when excludeInputOutputColumns=true (and excludeInputFiles is not set). Summary of inputContent.files without parser payloads.
Show child attributes
Show child attributes