---
title: "Ask for a new API key by email"
method: POST
path: "/v1/workspaces/recover"
tags: ["Account"]
---

# Ask for a new API key by email

`POST /v1/workspaces/recover`

## Request

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

For a lost key. When the address is the exact, confirmed owner address of a workspace, a link is emailed to that address. The link works once, expires in 15 minutes, and asks for a confirmation before it issues a new key. The answer is the same whether or not the address has a workspace. At most 3 emails per address per hour; above that the answer is the same and nothing is sent. At most 10 requests per network per hour.

No authentication.

## Request body

- object
  - `email` string, required

## Response `202`

Accepted. A link is sent when the address is the confirmed email of a workspace.

- object
  - `object` 'key_recovery_request', required
  - `message` 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.
- `429`: `rate_limited` (retry): Too many requests from this network. Try again later.

## Changes

- **2026-10-20** `ad27b35513a6`: 2 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 `429`

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