---
title: "File a public recovery intent"
method: POST
path: "/v1/recovery/intent"
tags: ["recovery"]
---

# File a public recovery intent

`POST /v1/recovery/intent`

## 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/intent`
- Auth: none declared

Public watchtower. POST ``agent_id`` alone to obtain a challenge. Then POST ``challenge_id`` + recovery-key signature over ``canonical_recovery_intent_bytes_v1`` to persist an open intent (7-day veto window). Enrolment grace still applies.

## Request body

- RecoveryIntentRequest
  - `agent_id` string, required
  - `challenge_id` string, nullable
  - `signature` string, nullable: RFC4648 base64 raw Ed25519 recovery-key signature over canonical_recovery_intent_bytes_v1

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