---
title: "Create Api Key"
method: POST
path: "/v2/integrations/api-keys"
tags: ["integrations-v2"]
---

# Create Api Key

`POST /v2/integrations/api-keys`

Create a new API key for the authenticated user.

The API key is returned ONCE in the response. Store it securely
as it cannot be retrieved again.

## Request body

- CreateApiKeyRequest — Request to create a new API key.
  - `name` string, required — Human-readable name for the API key (e.g., 'MCP key', 'CI key')

## Response `200`

Successful Response

- CreateApiKeyResponse — Response with newly created API key. WARNING: The `token` field contains the full API key and is only returned once during creation. Store it securely - it cannot be retrieved later.
  - `api_key` ApiKeyResponse, required — Public information about an API key (no secrets). This response is returned for list operations and includes only metadata about the key, not the actual secret.
    - `id` string, required — Unique identifier for the API key
    - `name` string, required — Human-readable name for the key
    - `prefix` string, required — Display prefix for the key (e.g., 'trv_ak_a7f3c9e2')
    - `created_at` string, date-time, required — When the key was created
  - `token` string, required — The full API key token. IMPORTANT: This is only shown once.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)