---
title: "Create agent key"
method: POST
path: "/v1/agent-keys"
tags: ["AgentKeys"]
---

# Create agent key

`POST /v1/agent-keys`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/v1/agent-keys`
- Auth: HTTP bearer

Mints a personal agent key (max 5 active). Full key returned once. Unlimited daily calls; per-minute throttle applies.

## Request body

- object
  - `name` string

## Response `201`

Key created

- object
  - `data` AgentKeyItem, required
    - `id` string, required
    - `prefix` string, required
    - `name` string, required
    - `dailyQuota` integer, nullable
    - `usedToday` integer
    - `isActive` boolean, required
    - `lastUsedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `key` string: Full key, returned only at creation

## Other responses

- `401`: Not authenticated
- `409`: Key limit reached

---

[API](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api.md) · [All operations](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/revisions/7f07b9ca718f?raw)