---
title: "Generate backup key"
method: POST
path: "/v1/auth/keys/generate-backup"
tags: ["auth"]
---

# Generate backup key

`POST /v1/auth/keys/generate-backup`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/auth/keys/generate-backup`
- Auth: HTTP bearer

Create a backup key (dormant until activated). Max 1 backup key at a time.
Activate with `POST /v1/auth/keys/activate-backup`.

## Request body

- object
  - `label` string

## Response `201`

Backup key generated

- object
  - `backup_key` string: Backup key — save securely, not shown again
  - `key_prefix` string
  - `status` string
  - `created_at` string, date-time
  - `warning` string

## Other responses

- `409`: A backup key already exists

---

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