---
title: "Create an API key"
method: POST
path: "/api/temporary-keys/"
tags: ["temporaryApiKeys"]
---

# Create an API key

`POST /api/temporary-keys/`

Create a new API key.

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string — Key name.
  - `expiry_date` string, date-time — Expiry date (ISO 8601).
  - `max_usage` integer — Max usage count. -1 = unlimited.
  - `rate_limit` integer — Calls per minute. Overridden by plan limit.
  - `spending_limit` number, double — Spending limit in USD for gateway usage.
  - `is_test` boolean — Test key (`true`) or production key (`false`).

## Response `201`

Created API key.

- TemporaryAPIKeysCreateApiKeyResponse201
  - `id` string — API key ID.
  - `name` string — Key name.
  - `prefix` string — Key prefix.
  - `is_test` boolean — Test or production key.
  - `expiry_date` string, date-time — Expiry date.
  - `max_usage` integer — Max usage count. -1 = unlimited.
  - `rate_limit` integer — Calls per minute.
  - `spending_limit` number, double — Spending limit in USD.
  - `created_at` string, date-time
  - `api_key` string — The API key value. Only returned on creation - store it securely.
  - `key_usage` integer — Number of times this key has been used.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/77d94e49bc7a/schema)