---
title: "Initialize Logout Flow for API Clients - Revoke a Session"
method: DELETE
path: "/sessions"
tags: ["public"]
---

# Initialize Logout Flow for API Clients - Revoke a Session

`DELETE /sessions`

Use this endpoint to revoke a session using its token. This endpoint is particularly useful for API clients
such as mobile apps to log the user out of the system and invalidate the session.

This endpoint does not remove any HTTP Cookies - use the Browser-Based Self-Service Logout Flow instead.

## Request body

- RevokeSession
  - `session_token` string, required — The Session Token Invalidate this session token.

## Response `204`

Empty responses are sent when, for example, resources are deleted. The HTTP status code for empty responses is typically 201.

## Other responses

- `400` — jsonError
- `500` — jsonError

## Changes

- **2021-05-18** `9123bcead5ed` — 4 info
  - the response property `error` became required for the status `400`
  - the response property `error` became required for the status `500`
  - the response property `error/message` became required for the status `400`
  - the response property `error/message` became required for the status `500`
- **2021-05-05** `381c760af46e` — 4 breaking, 3 warning, 6 info
  - added required request body
  - the response property `error` became optional for the status `400`
  - the response property `error/message` became optional for the status `400`
  - removed the success response with the status `200`
  - …9 more

[Change history](https://skmtc.dev/ory/apis/ory-identities-api/changes/sessions/delete.md)

---

[API](https://skmtc.dev/ory/apis/ory-identities-api.md) · [All operations](https://skmtc.dev/ory/apis/ory-identities-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ory/ory-identities-api/revisions/9123bcead5ed/schema)
