---
title: "Create API key"
method: POST
path: "/keys"
---

# Create API key

`POST /keys`

## Request

- Base URL: `https://namemy.app/api/v1`
- URL: `https://namemy.app/api/v1/keys`
- Auth: API key in cookie `next-auth.session-token`

Create a new API key for agent/programmatic access.
Requires session-based authentication.

## Request body

- object
  - `name` string
  - `permissions` string[]
  - `expiresInDays` integer: Optional expiration in days

## Response `200`

API key created (key shown only once)

- object
  - `key` ApiKeyWithSecret
    - `id` string
    - `name` string
    - `keyPrefix` string
    - `permissions` string[]
    - `rateLimit` integer
    - `lastUsedAt` string, date-time
    - `expiresAt` string, date-time
    - `isActive` boolean
    - `createdAt` string, date-time
    - `key` string: Full API key (shown only once)
  - `warning` string

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/namemy/apis/namemy-app-api.md) · [All operations](https://skmtc.dev/namemy/apis/namemy-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namemy/apis/namemy-app-api/revisions/1c302ede4b63?raw)