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

# Create an API key

`POST /api-keys`

Mints a fresh API key for the caller's organization. The plaintext key value is returned exactly once and never stored or returned again.

## Request body

- APIKeyCreateRequest — Request body for creating a new API key.
  - `name` string, required — Human-readable label for the API key.

## Response `201`

Created

- APIKeyCreateResponse — Response returned when a new API key is created.
  - `created_at` string, date-time, required — Timestamp when the key was created.
  - `id` string, required — API key identifier.
  - `key_value` string, required — Full plaintext key, shown only on creation.
  - `name` string, required — Human-readable label for the key.

## Other responses

- `default` — Error

## Changes

- **2026-08-17** `261c340a3f6d` — 1 breaking, 1 warning, 1 info
  - the `name` request property's minLength was increased from `0` to `1`
  - the `name` request property's maxLength was set to `100`
  - the endpoint scheme security `bearerAuth` was removed from the API

[Change history](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/api-keys/post.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/261c340a3f6d/schema)