List Tasks

List tasks with optional filtering

Returns tasks for the authenticated user with optional filtering by project and status.

Authentication

Requires a valid Bearer token.

Query Parameters

project_id · string

Filter tasks by project ID (UUID).

status · string

Filter tasks by status. One of: created, running, completed, failed, aborted.

Response

tasks · array

List of task objects.

Show Task object

id · string · required

Unique task identifier (UUID).

name · string

Task name (derived from the prompt).

status · string · required

Task status: created, running, completed, failed, aborted.

result · string

Task result summary on completion.

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.

200

{
  "tasks": [
    {
      "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"
    }
  ]
}

Errors

Status	Description
401	Unauthorized — missing or invalid token