Skip to content
Extrovert Extrovert Docs

Read a category's graduation gate status (console plane)

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

Read the gate status toward the next rung (the maturity gate + drift tripwire counters that drive the console graduation controls). The agent-plane read (GET /v1/categories/{id}/graduation-status) is AgentKey-only, so the console reads the SAME view here (Clerk session). Read-only; a foreign id is 404.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
org_id
required
string
project_id
required
string
id
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Ok

The graduation gate status toward the NEXT rung (Review Loop, D16). Reports clean approvals (N / needed), category age, the maturity gate (auto_silent precondition), the drift counter vs K, and whether a human graduate would succeed right now (can_graduate). Read-only; agents propose but never flip the bit.

object
category_id
required
string
state
required
string
Allowed values: supervised auto_notify auto_silent
next_state
required

The rung a graduate would move to (empty if none).

string
never_graduate
required

Pinned at supervised (high-stakes lock).

boolean
clean_approval_count
required
integer
graduate_min_approvals
required
integer
approvals_met
required
boolean
age_hours
required
number format: double
graduate_min_age_hours
required
integer
age_met
required
boolean
maturity_gate_met
required
boolean
drift_count
required
integer
drift_demote_after
required
integer
can_graduate
required
boolean

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