---
title: "Revoke an API key"
method: DELETE
path: "/v1/api-keys/{key_id}"
tags: ["Account"]
---

# Revoke an API key

`DELETE /v1/api-keys/{key_id}`

## Request

- Base URL: `https://api.recruitmcp.com`
- URL: `https://api.recruitmcp.com/v1/api-keys/{key_id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://recruitmcp.com/oauth/authorize`, token URL `https://recruitmcp.com/oauth/token`, scopes: `account:manage`)

Runs and jobs started with the key stop at their next step. Revoking the workspace's only active key leaves no key that can call the API, so it needs `?confirm_revoke=true`; without it the call is 409 confirmation_required and nothing is revoked. Create a new key first. If no key is left, "Lost your key?" on the console login emails a link to get a new one.

Scope: `account:manage`. Acts on the account; keys bound to a customer are refused.

## Path parameters

- `key_id` string, required

## Query parameters

- `confirm_revoke` boolean

## Headers

- `Idempotency-Key` string
- `RecruitMCP-Version` '2026-10-13'

## Response `204`

Deleted.

## Other responses

- `400`: `invalid_request` (do not retry): A field is missing or has a value this endpoint does not accept. `unsupported_version` (do not retry): RecruitMCP-Version is not a supported version.
- `401`: `unauthorized` (do not retry): Missing bearer API key.
- `403`: `forbidden` (do not retry): This route acts on the account. Keys bound to a customer cannot use it. `insufficient_scope` (do not retry): This key does not include the scope this endpoint requires.
- `404`: `not_found` (do not retry): No record with this id exists in the workspace.
- `409`: `conflict` (do not retry): The resource is in a state that refuses this change.
- `429`: `rate_limited` (retry): Per-key rate limit exceeded.

## Changes

- **2026-10-20** `ad27b35513a6`: 6 warning
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `400`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `401`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `403`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `404`
  - …2 more

[Operation history](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/changes/v1/api-keys/:key_id/delete.md)

---

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