Skip to main content
GET
/
v3
/
workspaces
/
{workspace_id}
/
queue
/
status
Get Queue Status
curl --request GET \
  --url https://api.honcho.dev/v3/workspaces/{workspace_id}/queue/status \
  --header 'Authorization: Bearer <token>'
{
  "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

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