---
title: "Create Api Key Route"
method: POST
path: "/auth/me/api-keys"
tags: ["auth"]
---

# Create Api Key Route

`POST /auth/me/api-keys`

## Request

- Base URL: `https://api.nicheangle.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nicheangle.com/auth/me/api-keys`
- Auth: none declared

Mint a new PAT. The plaintext is returned exactly once in the
response body — the UI must show it immediately and warn the user
they won't see it again.

PAT issuance is plan-gated (the locked pricing makes the agent surface
a paid feature): Creator/free = 0, Studio = 1, Operator = unlimited.
We gate minting, not per-call — the token IS the capability. Existing
keys on a now-ineligible plan are left intact (no retroactive
lockout); only NEW issuance is blocked.

## Headers

- `authorization` string, nullable

## Request body

- CreateKeyRequest
  - `name` string

## Response `200`

Successful Response

- CreateKeyResponse
  - `key` ApiKeyOut, required
    - `id` string, required
    - `name` string, required
    - `prefix` string, required
    - `created_at` string, required
    - `last_used_at` string, nullable, required
    - `disabled_at` string, nullable, required
    - `burn_24h_credits` integer
  - `plaintext` string, required

## Other responses

- `422`: Validation Error

---

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