Get Queue Status

Get the processing queue status for a Workspace, optionally scoped to an observer, sender, and/or session.

Only tracks user-facing task types (representation, summary, dream). Internal infrastructure tasks (reconciler, webhook, deletion) are excluded. Note: completed counts reflect items since the last periodic queue cleanup, not lifetime totals.

GET /v3/workspaces/{workspace_id}/queue/status

Get Queue Status

cURL

curl --request GET \
  --url https://api.honcho.dev/v3/workspaces/{workspace_id}/queue/status \
  --header 'Authorization: Bearer <token>'

200

{
  "total_work_units": 123,
  "completed_work_units": 123,
  "in_progress_work_units": 123,
  "pending_work_units": 123,
  "sessions": {}
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace_id · string · required

Query Parameters

observer_id · string | null

Optional observer ID to filter by

sender_id · string | null

Optional sender ID to filter by

session_id · string | null

Optional session ID to filter by

Response

200

application/json

Successful Response

Aggregated processing queue status.

Tracks user-facing task types only: representation, summary, and dream. Internal infrastructure tasks (reconciler, webhook, deletion) are excluded.

Note: completed_work_units reflects items since the last periodic queue cleanup, not lifetime totals.

total_work_units · integer · required

Total work units

completed_work_units · integer · required

Completed work units (since last periodic cleanup)

in_progress_work_units · integer · required

Work units currently being processed

pending_work_units · integer · required

Work units waiting to be processed

sessions · Sessions · object

Per-session status when not filtered by session

Show child attributes