---
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` number, double, nullable — Requests per minute. null uses the organization default.
  - `spending_limit` number, double — Spending limit in USD.
  - `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.
  - `created` string, date-time — When the API key was created.
  - `unique_organization_id` string, nullable — Owning organization UUID.

## Other responses

- `401` — Unauthorized

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 5 breaking, 1 warning, 29 info
  - the `rate_limit` request property type/format changed from `integer`/`` to `number, null`/`double`
  - the response property `expiry_date` became nullable for the status `201`
  - the response property `rate_limit` became nullable for the status `201`
  - the response property `spending_limit` became nullable for the status `201`
  - …31 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/temporary-keys/post.md)

---

[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/c61efaf24756/schema)