Skip to main content

Terminate an existing session​

Terminate your own session or if granted any other session.

Path Parameters
    sessionId string required

    "id of the session to terminate"

Request Body required
    sessionToken string

    "The current token of the session, previously returned on the create / update request. The token is required unless the authenticated user terminates the own session or is granted the session.delete permission."

Responses

OK

Schema
    details object
    sequence uint64

    on read: the sequence of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    changeDate date-time

    on read: the timestamp of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    resourceOwner resource_owner is the organization or instance_id an object belongs to
DELETE /v2beta/sessions/:sessionId

Authorization

name: OAuth2type: oauth2scopes: openid,urn:zitadel:iam:org:project:id:zitadel:audflows: {
  "authorizationCode": {
    "authorizationUrl": "$CUSTOM-DOMAIN/oauth/v2/authorize",
    "tokenUrl": "$CUSTOM-DOMAIN/oauth/v2/token",
    "scopes": {
      "openid": "openid",
      "urn:zitadel:iam:org:project:id:zitadel:aud": "urn:zitadel:iam:org:project:id:zitadel:aud"
    }
  }
}

Request

Base URL
https://$CUSTOM-DOMAIN
Bearer Token
sessionId — path required
Content-Type
Body required
{

  "sessionToken": "string"

}
Accept
curl / cURL
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/v2beta/sessions/:sessionId' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "sessionToken": "string"
}'