Revoke one of my sessions
DELETE /account/sessions/{id}
DELETE
/account/sessions/{id}
Ownership-checked: revokes only when the session id belongs to the caller. 404 covers both “wrong owner” and “no such session” so existence can’t be probed.
In demo mode (AA_DEMO_MODE=1) every visitor shares one
account, so the caller’s “other” sessions belong to other
people. Only the session authenticating the request may be
revoked; anything else is 403 (#567).
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
Responses
Section titled “ Responses ”Session revoked.
Authentication required, missing, or invalid
object
error
required
Human-readable error summary
string
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
error
required
Human-readable error summary
string
Example
the request could not be completedResource not found
object
error
required
Human-readable error summary
string
Example
the request could not be completed