AGagentarea
v1
protected
inbox

Get Inbox Items

Changed on

List tasks requiring user attention.

Returns tasks with actionable statuses (waiting_for_approval, completed, failed), newest call for attention first: when an ended run ended, when a waiting task began to wait. Includes total count for badge/pagination.

get/v1/workspaces/{workspace}/inbox/

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

workspacestring required

Slug of the workspace the request acts in

Query parameters

status'waiting_for_approval' | 'waiting_for_input' | 'completed' | 'failed' nullable

Filter to a specific inbox status

agent_idstring uuid nullable

Filter by agent ID

pageinteger
page_sizeinteger

Response

Successful Response

pageinteger required
page_sizeinteger required
totalinteger required

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
    • breaking

      for the query request parameter page_size, the max was decreased from 1000.00 to 200.00

    • info

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