List revoked principals

Sponsor token required. Lists the currently revoked principals in the sponsor’s tenant — the kill-switch roster. Check this before debugging a DENY you did not expect: a revoked principal denies regardless of policy or grants.

Authentication

AuthorizationBearer
Your Writ API key (writ_...) as an Authorization Bearer header. The sponsor token (writ_sp_...) is a separate credential used only for grants, revokes, and reinstate — it goes in the same Authorization header on those endpoints. In the Fern docs playground, paste the key here; it is stored in this browser only.

Headers

AuthorizationstringRequired

Bearer <sponsor token>.

Response

Revoked principal list for the tenant.

Errors

401
Unauthorized Error