curl --request POST \
--url https://api.tela.com/task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"promptApplicationId": "95cec438-6080-44fe-8275-28b16bd40178",
"name": "Invoice-2025-001.pdf",
"rawInput": {
"variables": {
"document": {
"file_url": "https://example.com/invoice.pdf",
"file_name": "Invoice-2025-001.pdf",
"mime_type": "application/pdf"
}
},
"webhook_url": "https://example.com/webhook"
},
"tags": [
"priority"
]
}
'[
{
"id": "8b6d2c9a-1f4e-4c1b-9a1e-3c2d5e6f7a80",
"reference": 43,
"name": "Invoice-2025-001.pdf",
"status": "running",
"rawInput": {
"application_id": "95cec438-6080-44fe-8275-28b16bd40178",
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf",
"file_name": "Invoice-2025-001.pdf",
"mime_type": "application/pdf"
}
]
}
},
"webhook_url": "https://example.com/webhook"
},
"inputContent": null,
"outputContent": null,
"originalOutputContent": null,
"createdBy": "api@company.com",
"approvedBy": null,
"approvedAt": null,
"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": null,
"tags": [
"priority"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T10:30:00.000Z",
"deletedAt": null
}
]Create tasks
Creates one or more tasks. The body may be a single task object, an array of up to 100 task objects (all must share the same promptApplicationId), or an agent batch object (sourceType: "agent").
curl --request POST \
--url https://api.tela.com/task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"promptApplicationId": "95cec438-6080-44fe-8275-28b16bd40178",
"name": "Invoice-2025-001.pdf",
"rawInput": {
"variables": {
"document": {
"file_url": "https://example.com/invoice.pdf",
"file_name": "Invoice-2025-001.pdf",
"mime_type": "application/pdf"
}
},
"webhook_url": "https://example.com/webhook"
},
"tags": [
"priority"
]
}
'[
{
"id": "8b6d2c9a-1f4e-4c1b-9a1e-3c2d5e6f7a80",
"reference": 43,
"name": "Invoice-2025-001.pdf",
"status": "running",
"rawInput": {
"application_id": "95cec438-6080-44fe-8275-28b16bd40178",
"variables": {
"document": {
"files": [
{
"file_url": "https://example.com/invoice.pdf",
"file_name": "Invoice-2025-001.pdf",
"mime_type": "application/pdf"
}
]
}
},
"webhook_url": "https://example.com/webhook"
},
"inputContent": null,
"outputContent": null,
"originalOutputContent": null,
"createdBy": "api@company.com",
"approvedBy": null,
"approvedAt": null,
"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": null,
"tags": [
"priority"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T10:30:00.000Z",
"deletedAt": null
}
]Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
- Workstation/App task · object
- Workstation/App task · object[]
- Agent tasks · object
The Workstation/App to create the task in. Required by the server (400 when missing); all tasks in a batch must use the same value.
Display name of the task (typically the document file name).
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
Pre-filled output. When present the task is stored in validating status without executing the Canvas.
Show child attributes
Show child attributes
Normalized input of the execution. null until the run has been prepared.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
The created tasks (always an array, even for a single-object body)
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