AGagentarea
v1
protected
agent-tasks

List Agent Tasks

Changed on

List all tasks for the specified agent.

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}/agents/{agent_id}/tasks/

Request

Path parameters

agent_idstring uuid required
workspacestring required

Slug of the workspace the request acts in

Query parameters

statusstring nullable

Filter by task status

limitinteger

Maximum number of tasks to return

offsetinteger

Number of tasks to skip

Response

Successful Response

agent_idstring uuid required
created_atstring date-time required
created_bystring nullable
descriptionstring required
end_user_idstring nullable
errorstring 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

  • 1d8a3995ec6cRevision changes
    • info

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