Get Task

Get a task by ID with full details

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.

200

{
  "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

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