AGagentarea
v1
protected
tasks

Get All Tasks

Changed on

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/

Request

Path parameters

workspacestring required

Slug of the workspace the request acts in

Query parameters

statusstring[] nullable

Filter to tasks in any of these statuses

created_bystring nullable

Filter by the principal that started it

searchstring nullable

Case-insensitive match on the description or the agent name

limitinteger

Maximum number of tasks to return

offsetinteger

Number of tasks to skip

Response

Successful Response

agent_idstring uuid required
agent_namestring nullable
created_atstring date-time required
created_bystring nullable
descriptionstring required
end_user_idstring nullable
errorstring nullable
escalation_idstring nullable
escalation_tool_namestring nullable
execution_idstring nullable
failure_reasonstring nullable
idstring uuid required
metadataobject nullable
parametersobject required
scheduled_atstring date-time nullable
statusstring required
total_costnumber nullable
total_tokensinteger nullable

Changes

  • 1868622eed6dRevision changes
    • warning

      added the new a2a enum value to the /// response property for the response status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • e11acdcae53fRevision changes
    • info

      added the enum value waiting_for_infrastructure to the property anyOf[subschema #1]/items/ of the query request parameter status