Get orchestration queue stats

GET 
/api/v1/orchestrations/queue/stats

Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (queue_depth), how many are currently claimed with a valid lease (claimed_tasks), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by GET /api/v1/orchestrations/queue/stats/projects. Intended for admin/operator policies; guarded by orchestrations:GetQueueStats. Every figure is scoped to what the caller may see. A project-scoped caller gets queue_depth and claimed_tasks summed over their own projects, and null for oldest_queued_age_seconds and the claim_latency_ms percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.

Responses

200

Queue stats snapshot

400

Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation

401

Unauthorized

403

Forbidden

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded