---
title: "Revoke API Token"
method: POST
path: "/orgs/{org_slug}/api-tokens/revoke"
tags: ["api-tokens"]
---

# Revoke API Token

`POST /orgs/{org_slug}/api-tokens/revoke`

Revoke an API Token

This endpoint consumes 10 units of your quota.

This endpoint requires the following org token scopes:
- api-tokens:revoke

## Path parameters

- `org_slug` string, required

## Request body

- object — The API token identifier to revoke. Provide uuid (recommended), id, token, or hash. May provide uuid+hash together for validation.
  - `uuid` string, uuid — The stable group UUID of the API token to revoke
  - `id` string — The API token ID to revoke
  - `token` string
  - `hash` string

## Response `200`

Response body

- object
  - `status` string, required — The status of the token

## Other responses

- `401` — Unauthorized
- `403` — Insufficient max_quota for API method
- `404` — Resource not found
- `429` — Insufficient quota for API route

---

[API](https://skmtc.dev/socket-dev/apis/socket.md) · [All operations](https://skmtc.dev/socket-dev/apis/socket/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socket-dev/socket/revisions/bf994b75d33f/schema)