Read the D19 backlog-reconciliation status (agent plane)
GET /v1/categories/{id}/backlog-status
Read a $0-LLM, non-mutating snapshot of the category’s QUEUED drafts reconciled by rules-version (D19/§8): how many are stale vs current-enough against the current category rules-version + house-style version (a pure integer compare). Read-only; an agent READS the picture; the human (console scan-backlog) or the graduate/rule-change hooks TRIGGER the actual reconciliation sweep. A foreign id is 404.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Responses
Section titled “ Responses ”Ok
The D19/§8 backlog-reconciliation snapshot for a category (agent-readable, $0-LLM). Counts the QUEUED drafts that are stale vs current-enough against the current category rules-version + house-style version (a pure integer compare). Read-only; the agent READS the picture; the human / hooks TRIGGER the sweep.
object
How many drafts are in the human queue (needs_review|in_review|chatting).
Of the queued, how many are within the staleness tolerance of the current rules-version.
Of the queued, how many were composed under older rules and need a redraft.
How many versions behind current a draft may be and still count current-enough.
Missing or invalid credential.
The canonical error envelope. error is a stable machine code.
object
Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).
Example
forbiddenHuman-readable detail (never leaks internals).
Example
missing required scopeMachine-readable quota reason. inbox_limit_exceeded means billing account inbox capacity across all organizations and projects sharing that account; enrollment_token_mailbox_budget_exhausted means the enrollment key lifetime creation allowance. Read message for recovery; inbox counts are separate from sending quotas.
Consumed plus reserved units.
Requested additional units.
Next UTC usage-period boundary; pending reservations survive this boundary.
Authenticated but lacking the required scope, or out of quota.
The canonical error envelope. error is a stable machine code.
object
Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).
Example
forbiddenHuman-readable detail (never leaks internals).
Example
missing required scopeMachine-readable quota reason. inbox_limit_exceeded means billing account inbox capacity across all organizations and projects sharing that account; enrollment_token_mailbox_budget_exhausted means the enrollment key lifetime creation allowance. Read message for recovery; inbox counts are separate from sending quotas.
Consumed plus reserved units.
Requested additional units.
Next UTC usage-period boundary; pending reservations survive this boundary.
Resource not found.
The canonical error envelope. error is a stable machine code.
object
Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).
Example
forbiddenHuman-readable detail (never leaks internals).
Example
missing required scopeMachine-readable quota reason. inbox_limit_exceeded means billing account inbox capacity across all organizations and projects sharing that account; enrollment_token_mailbox_budget_exhausted means the enrollment key lifetime creation allowance. Read message for recovery; inbox counts are separate from sending quotas.
Consumed plus reserved units.
Requested additional units.
Next UTC usage-period boundary; pending reservations survive this boundary.