---
title: "Enable or disable API token"
method: PUT
path: "/v1/api-keys/{id}"
tags: ["API Tokens"]
---

# Enable or disable API token

`PUT /v1/api-keys/{id}`

<Note>
  This endpoint requires **Organization Admin** permissions.
</Note>

Disable or re-enable an API token. To permanently revoke a token, use the [Delete API token](/api/api-tokens/delete-api-token) endpoint.

This operation is **idempotent**: calling it twice with the same body produces the same result.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `enabled` boolean, required — Determines if the API token is enabled: `false` to disable the token, `true` to re-enable it.

## Response `200`

Token updated successfully. Returns the current state of the token, or the same state if already in the requested state.

- object
  - `id` string, uuid — Unique ID for the token.
  - `name` string — Token name.
  - `type` 'organization' | 'personal' | 'mcp' — Token type.
  - `enabled` boolean — Whether the token is enabled.
  - `createdAt` string, date-time — ISO 8601 timestamp of when the token was created.
  - `membershipId` string, uuid, nullable — Membership ID of the user who owns the token. `null` for Organization API keys.

## Other responses

- `400` — Bad Request. Validation errors include: - `id: Invalid UUID` - The token ID is not a valid UUID format - `enabled: Invalid input: expected boolean, received string` - Non-boolean value provided for `enabled` - `Unrecognized key: "<field>"` - Unknown field in request body
- `403` — Forbidden. Requires Organization Admin permissions, or authentication failed.
- `404` — Not Found. The token does not exist or belongs to a different organization.
- `405` — Method Not Allowed - Invalid HTTP method for this endpoint
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)