POST /v1/auth/recovery/complete

POST /v1/auth/recovery/complete — consume a recovery token after the cooldown elapses. Removes ALL MFA factors and revokes every session. The user re-signs-in fresh and re-enrolls factors.

Tags: auth

Request body

Required.

JSON
{
  "$ref": "#/components/schemas/CompleteAccountRecoveryRequest"
}

Responses

200

JSON
{
  "$ref": "#/components/schemas/CompleteAccountRecoveryResponse"
}

400 — INVALID_REQUEST — bad / not-yet-eligible / already-used token

Code samples

TypeScript

TypeScript
import { firecase } from "@firecase/sdk";

const result = await firecase.post("/auth/recovery/complete", { /* body */ });
console.log(result);

Python

Python
import firecase

result = firecase.post("/auth/recovery/complete", json={})
print(result)

curl

Bash
curl -X POST https://api.firecase.ai/v1/auth/recovery/complete \
  -H "Authorization: Bearer $FIRECASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'