Skip to content

Revoke every session of an account for the calling application.

POST
/revoke-all
curl --request POST \
--url https://connect-api.sudomimus.com/revoke-all \
--header 'Content-Type: application/json' \
--data '{ "subject": "example" }'

Revokes all refresh tokens belonging to the given account that were issued for the calling application (log out everywhere). This is an application-authority action — not something a single session capability can authorize — so it requires a client-auth JWT, exactly like /establish. Revocation is scoped to the calling application; sessions of the same account under other applications are unaffected.

Media type application/json
object
subject
required

The sector subject the application sees for the user (the access / id token sub). Reverse-mapped server-side to the underlying account, whose sessions are then revoked for the calling application. A subject the application has never been issued (or one from another sector) revokes nothing.

string
Example generated
{
"subject": "example"
}

Number of sessions revoked.

Media type application/json
object
revokedCount
required

Number of refresh tokens that were revoked.

integer
Example generated
{
"revokedCount": 1
}

Client-auth JWT missing, malformed, expired, or invalid.

Media type application/json

Error response body. The Connect service emits { "reason": "<SymbolDescription>" } for known failure modes. When the reason symbol’s description begins with PRIVATE, the body is empty (zero bytes) and only the HTTP status carries signal — both reason and the body itself are absent in that case.

object
reason

Stable machine-readable reason code.

string
Example generated
{
"reason": "example"
}

Error response.

Media type application/json

Error response body. The Connect service emits { "reason": "<SymbolDescription>" } for known failure modes. When the reason symbol’s description begins with PRIVATE, the body is empty (zero bytes) and only the HTTP status carries signal — both reason and the body itself are absent in that case.

object
reason

Stable machine-readable reason code.

string
Example generated
{
"reason": "example"
}