Terminate an identity session

DELETE

/identity-sessions/{id}

Ends an active identity session, immediately invalidating it so it can no longer be used to authenticate requests. This is typically used to implement "log out" or to forcibly revoke a specific session (for example, one shown in a "active sessions" list). The operation is idempotent in the sense that it only succeeds against a session currently in the active state — attempting to terminate a session that has already been terminated returns a 400 error rather than silently succeeding again.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

The session was terminated successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/identity-sessions/01JABC1234567890ABCDEFGHIJ' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Session terminated successfully",
    "status": "success",
    "data": {
        "id": "01JABC1234567890ABCDEFGHIJ",
        "status": "terminated"
    }
}

Modified at 2026-09-28 09:30:45

Terminate all active sessions for an identity

Create an additional named entity sandbox