Skip to navigation

Disconnect your OAuth grant

Required scopes: token.delete.

Requires an existing finite bt_ personal credential. Delegated OAuth tokens cannot administer grants. Owner-only, current personal authority; no token/hash exposure. Returns at most twenty current grants. Revocation immediately denies access and refresh. Other users receive 404. Browser equivalent is /settings/connected-apps. Requires token.delete in current user authority and explicit bt_ scopes when scoped.

Authentication

AuthorizationBearer

Personal bearer credential issued through existing account settings or browser-approved CLI flow. Must be active, finite, unexpired, unrevoked, within any rotation overlap, and bound to an active personal membership/user/account. Explicit scopes intersect current user permissions; empty existing personal scopes inherit current user authority. Not an OAuth grant or service token. Browser cookies are ignored.

Path parameters

grant_idstringRequiredformat: "^[a-f0-9]{32}$"

Response

Disconnected.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error