Read a category's backlog reconciliation status (console plane)

GET

/v1/admin/orgs/{org_id}/projects/{project_id}/categories/{id}/backlog-status

• Production
• Local

Read the $0-LLM, read-only D19 snapshot of how many queued drafts are stale vs current-enough against the current rules-version (§8). The agent-plane read (GET /v1/categories/{id}/backlog-status) is AgentKey-only, so the console reads the SAME view here (Clerk session) for its reconciliation panel; the human scan-backlog button TRIGGERS the sweep. Read-only; a foreign id is 404.

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

id

required

string

Responses

200

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

category_id

required

string

state

required

string

Allowed values: supervised auto_notify auto_silent probation

queued

required

How many drafts are in the human queue (needs_review|in_review|chatting).

integer

current_enough

required

Of the queued, how many are within the staleness tolerance of the current rules-version.

integer

stale

required

Of the queued, how many were composed under older rules and need a redraft.

integer

current_category_rules_version

required

integer

current_house_style_version

required

integer

staleness_tolerance

required

How many versions behind current a draft may be and still count current-enough.

integer

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

403

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

404

Resource not found.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope