> For the complete documentation index, see [llms.txt](https://docs.layerlens.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layerlens.ai/more-in-this-section-9/api-keys.md).

# API keys

REST — API keys endpoints.

| Method | Path                                 | Description               |
| ------ | ------------------------------------ | ------------------------- |
| POST   | `/api/v1/admin/api-keys`             | Create a new API key      |
| GET    | `/api/v1/admin/api-keys`             | List (masked)             |
| DELETE | `/api/v1/admin/api-keys/{id}`        | Revoke                    |
| POST   | `/api/v1/admin/api-keys/{id}/rotate` | Rotate (24h grace period) |
| GET    | `/api/v1/admin/api-keys/{id}/usage`  | Usage stats               |

## Scopes

| Scope            | Meaning                   |
| ---------------- | ------------------------- |
| `traces:read`    | Read traces and telemetry |
| `traces:write`   | Create/update traces      |
| `replay:execute` | Execute replay sessions   |
| `feedback:write` | Submit feedback           |
| `feedback:read`  | Read feedback             |
| `admin`          | Full admin                |
| `ingest`         | Push telemetry            |

## See also

* [Auth](/more-in-this-section-9/auth.md)