---
title: "POST /api/v1/tokens/{id}/actions/revoke"
method: POST
path: "/api/v1/tokens/{id}/actions/revoke"
---

# POST /api/v1/tokens/{id}/actions/revoke

`POST /api/v1/tokens/{id}/actions/revoke`

## Path parameters

- `id` integer, required

## Response `200`

OK

- RevokeTokenResponseBody
  - `event` Event, required
    - `actor` string, required
    - `content_hash` string, required
    - `created_at` string, date-time, required
    - `hlc_counter` integer, required
    - `hlc_physical_ms` integer, required
    - `id` integer, required
    - `issue_id` integer
    - `issue_short_id` string
    - `issue_uid` string
    - `origin_instance_uid` string, required
    - `payload` string, required
    - `project_id` integer, required
    - `project_name` string, required
    - `project_uid` string, required
    - `related_issue_id` integer
    - `related_issue_short_id` string
    - `related_issue_uid` string
    - `type` string, required
    - `uid` string, required
  - `token` TokenOut, required
    - `actor` string, required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time
    - `id` integer, required
    - `last_used_at` string, date-time, nullable, required
    - `name` string, nullable, required
    - `revoked_at` string, date-time, nullable, required
    - `scope` TokenScopeOut
      - `kind` 'issue_subtree', required
      - `project_uid` string, required
      - `root_issue_uid` string, required
    - `state` 'live' | 'expired' | 'revoked', required

## Other responses

- `default` — Error

## Changes

- **2026-09-16** `2916e577ef54` — 3 info
  - added the optional property `token/expires_at` to the response with the `200` status
  - added the optional property `token/scope` to the response with the `200` status
  - added the required property `token/state` to the response with the `200` status

[Change history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/tokens/:id/actions/revoke/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) · [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/eec9b2fb4675?raw)