Skip to content

Revoke the session behind a refresh token.

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

Revokes the single session identified by the supplied refresh token (RFC 7009 style). Possession of a genuine refresh token authorizes the revocation, so no client-auth JWT is required.

The operation is idempotent: a token that is already revoked or expired reports revoked: true, and a token that cannot be resolved reports revoked: false without revealing whether it ever existed.

Media type application/json
object
refreshToken
required

The refresh token (JWT) whose session should be revoked.

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

Revocation outcome.

Media type application/json
object
revoked
required

True if the session is now revoked, including sessions that were already revoked or expired.

boolean
Example generated
{
"revoked": true
}

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"
}