v1
protected
tasks

Get All Tasks

Get one page of the workspace's tasks across all agents, newest first.

Access Control: Returns all tasks within the current user's workspace (workspace isolation). All users in the same workspace can see all workspace tasks.

get/v1/workspaces/{workspace}/tasks/

Path parameters

workspacestring required

Slug of the workspace the request acts in

Slug of the workspace the request acts in

Query parameters

statusstring[] nullable

Filter to tasks in any of these statuses

Filter to tasks in any of these statuses

created_bystring nullable

Filter by the principal that started it

Filter by the principal that started it

searchstring nullable

Case-insensitive match on the description or the agent name

Case-insensitive match on the description or the agent name

limitinteger

Maximum number of tasks to return

Maximum number of tasks to return

offsetinteger

Number of tasks to skip

Number of tasks to skip

Response

Successful Response

agent_idstring uuid required
agent_namestring nullable
created_atstring required
created_bystring nullable
descriptionstring required
errorstring nullable
escalation_idstring nullable
escalation_tool_namestring nullable
execution_idstring nullable
failure_reasonstring nullable
idstring uuid required
parametersobject required
scheduled_atstring nullable
statusstring required
total_costnumber nullable

Changes

Changed in 2 of the 51 revisions of this API.11