---
title: "Create Key"
method: POST
path: "/v1/account/agent-keys"
tags: ["Agent keys"]
---

# Create Key

`POST /v1/account/agent-keys`

## Request

- Base URL: `https://api.lyricpatch.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lyricpatch.com/v1/account/agent-keys`
- Auth: HTTP bearer

## Headers

- `x-dev-user-id` string, nullable
- `x-dev-email` string, nullable

## Request body

- AgentKeyCreate
  - `name` string, required
  - `scopes` string[], required
  - `project_ids` string[], nullable
  - `daily_credit_limit` integer
  - `expires_in_days` integer
  - `legal_version` string, required
  - `rights_attested` true, required

## Response `201`

Successful Response

- AgentKeyCreated
  - `id` string, uuid, required
  - `name` string, required
  - `key_prefix` string, required
  - `scopes` string[], required
  - `project_ids` string[], nullable
  - `daily_credit_limit` integer, required
  - `credits_used_today` integer
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, required
  - `revoked_at` string, date-time, nullable
  - `last_used_at` string, date-time, nullable
  - `secret` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lyricpatch/apis/lyricpatch-api.md) · [All operations](https://skmtc.dev/lyricpatch/apis/lyricpatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lyricpatch/apis/lyricpatch-api/revisions/307fbddfa9b0?raw)