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

# Check a key recovery link

`POST /v1/workspaces/recover/link`

## Request

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

Names the workspace a recovery link is for, without using the link. Same 404 for a link that is invalid, used, or expired.

No authentication.

## Request body

- object
  - `token` string, required

## Response `200`

The link is live.

- object
  - `object` 'key_recovery_link', required
  - `workspace_name` string, required
  - `expires_at` string, required

## 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/link/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)