---
title: "Handler Mint"
method: POST
path: "/identity/api_keys"
tags: ["api_keys", "identity"]
---

# Handler Mint

`POST /identity/api_keys`

## Headers

- `Idempotency-Key` string, required

## Request body

- CustomerCreateInput
  - `environment` 'test' | 'live', required
  - `name` string, required
  - `scopes` string[], nullable
  - `totp_code` string, required

## Response `200`

OK

- CustomerSecretOutput
  - `api_key` CustomerAPIKey
    - `api_version` string
    - `created_ts` string, date-time
    - `environment` 'test' | 'live'
    - `id` string
    - `key_prefix` string
    - `key_suffix` string
    - `name` string
    - `revoked_ts` string, date-time, nullable
    - `scopes` string[], nullable
  - `secret` string

## Other responses

- `default` — Error response.

## Changes

- **2026-09-08** `24358bd7b74f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/identity/api_keys/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/24358bd7b74f?raw)