---
title: "Request recovery link"
method: POST
path: "/v1/vault/recover"
tags: ["vault-legacy"]
---

# Request recovery link

`POST /v1/vault/recover`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/vault/recover`
- Auth: none required

Send a magic link to the recovery email. The link is single-use and expires in 15 minutes.
On click, redirects to `GET /v1/vault/recover/verify?token=...` which returns the
encrypted seed blobs.

## Request body

- object
  - `email` string, email, required

## Response `200`

Recovery link sent (or silently no-op if no vault entries for email)

- object
  - `sent` boolean
  - `message` string

## Other responses

- `429`: Rate limited (3 attempts per email per hour)

---

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