---
title: "Issue Api Key"
method: POST
path: "/v1/api-keys"
tags: ["api-keys"]
---

# Issue Api Key

`POST /v1/api-keys`

## Request

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

## Headers

- `authorization` string, nullable

## Request body

- IssueApiKeyRequest
  - `name` string, required

## Response `201`

Successful Response

- IssuedApiKeyResponse: Returned ONCE, at creation. `api_key` is the plaintext secret — it is never retrievable again, so the tenant must store it now.
  - `id` string, required
  - `name` string, required
  - `prefix` string, required
  - `api_key` string, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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