---
title: "Get Queue Status"
method: GET
path: "/v3/workspaces/{workspace_id}/queue/status"
tags: ["workspaces"]
---

# Get Queue Status

`GET /v3/workspaces/{workspace_id}/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.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `observer_id` string, nullable — Optional observer ID to filter by
- `sender_id` string, nullable — Optional sender ID to filter by
- `session_id` string, nullable — Optional session ID to filter by

## Response `200`

Successful Response

- QueueStatus — 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` object, nullable — Per-session status when not filtered by session

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/clawdsolana/apis/honcho-api.md) · [All operations](https://skmtc.net/clawdsolana/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clawdsolana/honcho-api/versions/0730be052dc9/schema)