Skip to content
Extrovert Extrovert Docs

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 ”
id
required
string

Responses

Section titled “ Responses ”

200

Section titled “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

Section titled “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

Section titled “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

Section titled “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