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

# Create API key

`POST /v1/keys`

## Request

- Base URL: `https://api.toolrouter.com`
- URL: `https://api.toolrouter.com/v1/keys`
- Auth: HTTP bearer

## Request body

- object
  - `name` string: Human-readable label

## Response `201`

New API key (secret shown once)

- ApiKey
  - `id` string, required
  - `name` string, required
  - `secret` string: Full key; returned only when created
  - `key_prefix` string
  - `status` string

## Other responses

- `400`: Machine-readable ToolRouter error
- `401`: Machine-readable ToolRouter error
- `403`: Machine-readable ToolRouter error
- `default`: Machine-readable ToolRouter error

---

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