---
title: "Confirm a key recovery"
method: POST
path: "/v1/workspaces/recover/confirm"
tags: ["Account"]
---

# Confirm a key recovery

`POST /v1/workspaces/recover/confirm`

## Request

- Base URL: `https://api.recruitmcp.com`
- URL: `https://api.recruitmcp.com/v1/workspaces/recover/confirm`
- Auth: none required

Uses the link once. Returns a new API key, shown once, with the scopes the old keys had. The workspace's other secret keys are revoked. Keys bound to a customer and OAuth connections stay. A confirmation email goes to the workspace address with the keys and connections still active and how to revoke them. Same 404 for a link that is invalid, used, or expired.

No authentication.

## Request body

- object
  - `token` string, required

## Response `200`

The new key.

- object
  - `object` 'key_recovery', required
  - `workspace_id` string, required
  - `workspace_name` string, required
  - `api_key` string, required: Shown once.
  - `key_prefix` string, required
  - `revoked_keys` integer, required: Old keys revoked.

## 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.
- `404`: `invalid_recovery_link` (do not retry): This recovery link is invalid, used, or expired. Ask for a new one at /recover.
- `429`: `rate_limited` (retry): Too many requests from this network. Try again later.

## Changes

- **2026-10-20** `ad27b35513a6`: 3 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 `404`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `429`

[Operation history](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/changes/v1/workspaces/recover/confirm/post.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)