Skip to content

End one of my sessions

DELETE
/account/sessions/{id}

Signs out one of your sessions. Use an id from GET /account/sessions. You can end the session you’re using too: its cookie stops working from the next request, although this response doesn’t clear it from the browser.

You get 404 if the id isn’t one of your sessions or that session was already revoked, so you can’t tell whether someone else’s session exists. A session that has only expired can still be ended, with 204. API tokens aren’t affected. Ending a session is recorded in the audit log as session.revoked on a best-effort basis.

In demo mode (AA_DEMO_MODE), where every visitor shares one account, you can only end the session making the request: anything else, and any request with an API token, gets 403.

id
required
string format: uuid

The session’s id, from GET /account/sessions.

The session has ended.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"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 completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed