v1
protected
inbox

Get Inbox Items

List tasks requiring user attention.

Returns tasks with actionable statuses (waiting_for_approval, completed, failed), ordered by most recently updated first. Includes total count for badge/pagination.

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

Path parameters

workspacestring required

Slug of the workspace the request acts in

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

Filter to a specific inbox status

agent_idstring uuid nullable

Filter by agent ID

Filter by agent ID

pageinteger
page_sizeinteger

Response

Successful Response

pageinteger required
page_sizeinteger required
totalinteger required

Changes