---
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

- **2026-06-29** `a638dcb24d6f` — 4 breaking, 8 info
  - response property `detail` list-of-types was widened by adding types `array and object` to media type `application/json` of response `401`
  - response property `last_used_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `scopes` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `detail` response's property type/format changed from `string`/`` to `array`/`` for status `422`
  - …8 more
- **2026-04-27** `7ee643294766` — 2 info
  - added the new optional request property `scopes`
  - added the optional property `scopes` to the response with the `200` status
- **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/a638dcb24d6f/schema)