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

# Create API Key

`POST /v1/api-keys`

Create a new API key for the authenticated user. The full secret is returned **once** in `data.key` — save it immediately. Subsequent listings only show the prefix. Requires Privy JWT auth (web dashboard); cannot be called with an existing API key.

## Request body

- object
  - `name` string — Optional display name for the key.

## Response `201`

API key created (full key visible once)

- object
  - `data` ApiKeyFull, required — Returned only on creation; the full `key` is visible exactly once.
    - `key` string — Full API key (only shown once).
    - `key_prefix` string
    - `name` string
    - `created_at` string, date-time
    - `expires_at` string, date-time

## Other responses

- `401` — Missing or invalid authentication

---

[API](https://skmtc.net/totalistrading/apis/totalis-rfq-api.md) · [All operations](https://skmtc.net/totalistrading/apis/totalis-rfq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totalistrading/totalis-rfq-api/revisions/b0adb9a590b4/schema)