リファレンスHTTP APIAuth

Revoke the session cookie

POST
/v1/auth/logout

Revokes the cookie session that sent the request and clears the cookie. The user's other sessions stay signed in.

Auth: cookie session only; no scope. Idempotency-Key: ignored.

Authorization

cookieSession
cookie__Host-werft_session<token>

For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.

Header Parameters

X-Requested-With?"werft-web"

Required with a cookie session: the literal werft-web.

Value in"werft-web"

Response Body

The session is revoked and the cookie cleared.

Example Request
curl -X POST 'https://example.com/v1/auth/logout'
Example Response
Empty