Skip to main content
GET
List tasks

Authorizations

Authorization
string
header
required

Workspace API key issued from the web app. Pass as Authorization: Bearer YOUR_API_KEY.

Query Parameters

cursor
string

Opaque pagination cursor returned by a previous response in next_cursor. Omit on the first request.

limit
integer
default:20

Maximum number of items to return. Defaults to 20; max 100.

Required range: 1 <= x <= 100
agent_id
string<uuid>

Only return tasks created from this agent version. Each publish creates a new version id, so this filter misses tasks run by older versions — use agent_group_id to match an agent across all of its versions.

agent_group_id
string<uuid>

Only return tasks created from any version of this agent. The group id is stable across publishes (see GET /api/v1/agents/{agent_id}/versions).

status
string

Comma-separated list of statuses to include (pending, queued, running, waiting_for_input, awaiting_review, completed, failed, stopped).

created_after
string<date-time>

ISO-8601 timestamp; only tasks created at or after this instant.

created_before
string<date-time>

ISO-8601 timestamp; only tasks created at or before this instant.

q
string

Substring match against task title (case-insensitive).

source
enum<string>
default:production

Which task bucket to list.

  • production (default) — live tasks. This is every task in the workspace regardless of how it was started (API, trigger, schedule, chat, …) except test tasks; it is the endpoint's long-standing default, unchanged.
  • test — only runs created with source: "test".
  • all — both of the above.

Any other value returns 400.

Available options:
production,
test,
all

Response

Paginated list of tasks.

data
object[]
required
has_more
boolean
required
next_cursor
string | null