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

# Create API key

`POST /v1/dev/keys`

Create a new developer API key. The full key is only returned once — store it securely immediately.

## Request body

- CreateApiKey
  - `name` string, required — Descriptive name for the key.

## Response `200`

The created API key with full secret.

- ApiKeyCreated
  - `id` string
  - `name` string
  - `key_prefix` string
  - `key` string — The full API key. **Only returned once during creation.**
  - `created_at` string, date-time
  - `last_used_at` string, date-time, nullable

## Other responses

- `401` — Invalid or missing API key.
- `422` — Validation error.

## Changes

- **2026-03-24** `b791dc93aa91` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/keys/post.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/b791dc93aa91/schema)