---
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

---

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