---
title: "Revoke an agent session"
method: POST
path: "/auth/agent/revoke"
---

# Revoke an agent session

`POST /auth/agent/revoke`

## Request

- Base URL: `https://superskill.sh/api`
- URL: `https://superskill.sh/api/auth/agent/revoke`
- Auth: one of:
  - HTTP bearer
  - none

Accepts the access bearer, a refresh token in the JSON body, or both. Revocation invalidates the session and all access tokens without returning credential material.

## Request body

- object
  - `refresh_token` string

## Response `200`

Session revoked or already absent

- object
  - `revoked` unknown, required

## Other responses

- `400`: Bad request
- `503`: Dependent service unavailable

---

[API](https://skmtc.dev/superskill/apis/superskill-api.md) · [All operations](https://skmtc.dev/superskill/apis/superskill-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superskill/apis/superskill-api/revisions/ced2d2d1f217?raw)