Skip to main content
Returns a single task by its ID, including events and messages.

​
Authentication

Requires a valid Bearer token.

​
Path Parameters

​
taskID
string
required
Task ID (UUID).

​
Response

​
id
string
required
Unique task identifier (UUID).
​
name
string
Task name.
​
status
string
required
Task status: created, running, completed, failed, aborted.
​
result
string
Task result summary.
​
error
string
Error message if the task failed.
​
summary
string
Brief summary of what the task accomplished.
​
created_at
string
required
ISO 8601 timestamp.
​
completed_at
string
ISO 8601 timestamp when the task finished.
​
events
array
List of task events (tool calls, file changes, etc.).
​
messages
array
List of conversation messages between the user and agent.
{
  "id": "c3d4e5f6-7890-12ab-cdef-345678901bcd",
  "name": "Add login page",
  "status": "completed",
  "result": "Created login page with email/password form",
  "error": null,
  "summary": "Added a login page component with form validation",
  "created_at": "2025-01-15T10:30:00Z",
  "completed_at": "2025-01-15T10:35:00Z",
  "events": [],
  "messages": []
}

​
Errors

StatusDescription
401Unauthorized — missing or invalid token
404Not Found — task does not exist or you do not have access