---
title: "Create API Key"
method: POST
path: "/v1/user/api-keys"
tags: ["User"]
---

# Create API Key

`POST /v1/user/api-keys`

Create a new API key. The plaintext `key` is returned **once** in this response and never again — store it securely. The key works immediately as a maker `X-API-Key` for the quote-request stream and REST endpoints, attributed to your `makerId`.

## Request body

- CreateApiKeyInput
  - `name` string — Optional label for the key.

## Response `201`

Key created (plaintext returned once)

- ApiKeyCreatedResponse
  - `success` true
  - `key` string — The plaintext API key. Shown ONCE — store it now.
  - `apiKey` ApiKeyMeta — API key metadata. Never includes the secret.
    - `id` string, uuid
    - `name` string
    - `keyPrefix` string — Non-secret prefix for identification.
    - `createdAt` string, date-time
    - `lastUsedAt` string, date-time, nullable
    - `revokedAt` string, date-time, nullable

## Other responses

- `401` — Error
- `503` — Error

---

[API](https://skmtc.dev/convallax/apis/convallax-rfq-api.md) · [All operations](https://skmtc.dev/convallax/apis/convallax-rfq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convallax/convallax-rfq-api/revisions/c8cb11b778c1/schema)