Skip to main content
POST
Create a virtual key with a budget

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
label
string
required
Example:

"CI pipeline key"

keyClass
enum<string>
required
Available options:
interactive,
ci
budgetUsd
number
required

Monthly budget in USD

Example:

50

rpmLimit
number | null

Max requests per minute. null or 0 = unlimited.

Example:

60

tpmLimit
number | null

Max tokens per minute. null or 0 = unlimited.

Example:

100000

ownerId
string | null

User who owns/uses this key. Must belong to the caller’s tenant. Omitted or null = ownerless (CI/service key).

teamId
string | null

Cost-center team this key bills to. Must belong to the caller’s tenant. When omitted and ownerId is set, defaults to that owner’s current team. Explicit null = unassigned (no team).

Response

201

Key created — rawKey shown once