---
title: "Create an API key — full secret returned once, never again"
method: POST
path: "/v1/api-keys"
tags: ["account"]
---

# Create an API key — full secret returned once, never again

`POST /v1/api-keys`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/api-keys`
- Auth: none declared

Generates a new API key shaped tmai_live_<8hex>.<32urlsafe>. The full key is returned in api_key on this response only; subsequent reads via GET /v1/api-keys return key_prefix only. Store the full key securely on creation.

## Headers

- `authorization` string, nullable

## Request body

- ApiKeyCreate
  - `name` string

## Response `201`

Successful Response

- ApiKeyCreateResponse
  - `id` string, required
  - `name` string, nullable
  - `key_prefix` string, required
  - `created_at` string, date-time, nullable
  - `last_used_at` string, date-time, nullable
  - `expires_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable
  - `api_key` string, required

## Other responses

- `422`: Validation Error

---

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