# Create an API key

> POST /api-keys

Source: https://docs.trykintsugi.com/reference/2026-07-21/create-an-api-key

POST /api-keys

Create an API key

Create an API key and return its one-time secret token (shown only here). Requires a user credential (an Owner or Admin) or a PORTFOLIO-scope Api-Key. Select an organization with an `Organization-Id` to create an organization key (a portfolio Owner/Admin bearer, or a portfolio Api-Key, selecting a client org creates a client-scoped key); omit it to create a portfolio-wide key if you are a portfolio Owner or Admin bearer. Portfolio and client keys are capped: creating one past the cap returns 409.

Category: API Keys

Request body:
expiresAt (string) - When the key should expire (RFC-3339 UTC with an explicit Z). Must be in the future. Omit for a key that does not expire.

Response fields:
id (string, required) - Opaque unique identifier of the created key. Treat as opaque.
token (string, required) - The secret API-key token. Shown ONCE, here, at creation; it cannot be retrieved later. Store it securely.

Response statuses: 201, 400, 401, 403, 404, 409, 422, 503

---

Index of every page: https://docs.trykintsugi.com/llms.txt