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

## Changes

> 10 revisions in range; 2 could not be searched.

- **2026-02-26** (v3) `0730be052dc9` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/plastic-labs/apis/honcho-api/changes/v3/workspaces/:workspace_id/queue/status/get.md)

---

[API](https://skmtc.dev/plastic-labs/apis/honcho-api.md) · [All operations](https://skmtc.dev/plastic-labs/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastic-labs/honcho-api/revisions/63b701d883c9/schema)