Skip to main content
GET
Get All Tasks

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Query Parameters

status
enum<string>[] | null

Filter to tasks in any of these statuses

Available options:
submitted,
pending,
preparing,
scheduled,
running,
working,
waiting_for_input,
waiting_for_approval,
waiting_for_continuation,
waiting_for_infrastructure,
blocked,
completed,
failed,
cancelled
created_by
string | null

Filter by the principal that started it

search
string | null

Case-insensitive match on the description or the agent name

limit
integer
default:100

Maximum number of tasks to return

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of tasks to skip

Required range: 0 <= x <= 1000000000

Response

Successful Response

agent_id
string<uuid>
required
created_at
string<date-time>
required
description
string
required
id
string<uuid>
required
parameters
Parameters · object
required
status
string
required
agent_name
string | null
created_by
string | null
end_user_id
string | null
error
string | null
escalation_id
string | null
escalation_tool_name
string | null
execution_id
string | null
failure_reason
string | null
metadata
Metadata · object | null
provenance
TaskProvenance · object

Why a task exists: who or what started it, and the event that caused it.

result
scheduled_at
string<date-time> | null
total_cost
number | null
total_tokens
integer | null