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

# Create Key

`POST /v1/dev/keys`

Create a new Developer API key with optional scopes.

- **name**: Descriptive name for the key
- **scopes**: Optional list of scopes. If not provided, defaults to read-only access.
  Available scopes:
  - conversations:read
  - conversations:write
  - memories:read
  - memories:write
  - action_items:read
  - action_items:write
  - goals:read
  - goals:write

## Request body

- DevApiKeyCreate
  - `name` string, required
  - `scopes` string[], nullable

## Response `200`

Successful Response

- DevApiKeyCreated
  - `created_at` string, date-time, required
  - `id` string, required
  - `key` string, required
  - `key_prefix` string, required
  - `last_used_at` string, date-time, nullable
  - `name` string, required
  - `scopes` string[], nullable

## Other responses

- `401` — Missing or invalid authentication credentials.
- `422` — Validation Error

## Changes

> 28 revisions in range; 3 could not be searched.

- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Full 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/3add0ce9bc4f/schema)