4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB

temporaryApiKeys

Create an API key

Create a new API key.

post/api/temporary-keys/

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

namestring

Key name.

expiry_datestring date-time

Expiry date (ISO 8601).

max_usageinteger

Max usage count. -1 = unlimited.

rate_limitinteger

Calls per minute. Overridden by plan limit.

spending_limitnumber double

Spending limit in USD for gateway usage.

is_testboolean

Test key (true) or production key (false).

Response

Created API key.

idstring

API key ID.

namestring

Key name.

prefixstring

Key prefix.

is_testboolean

Test or production key.

expiry_datestring date-time

Expiry date.

max_usageinteger

Max usage count. -1 = unlimited.

rate_limitnumber double nullable

Requests per minute. null uses the organization default.

spending_limitnumber double

Spending limit in USD.

api_keystring

The API key value. Only returned on creation - store it securely.

key_usageinteger

Number of times this key has been used.

createdstring date-time

When the API key was created.

unique_organization_idstring nullable

Owning organization UUID.