---
title: "Begin recovery challenge"
method: POST
path: "/v1/recovery/initiate"
tags: ["recovery"]
---

# Begin recovery challenge

`POST /v1/recovery/initiate`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/recovery/initiate`
- Auth: none declared

Public endpoint. Returns a complete-challenge only when an open recovery intent exists and the 7-day veto window has elapsed with no veto. If no intent is on file, file one at ``POST /v1/recovery/intent`` first.

## Request body

- RecoveryInitiateRequest
  - `agent_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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