Skip to main content
POST
Mint a spend token

Authorizations

Authorization
string
header
required

An agent API key, krt_live_... or krt_test_..., shown exactly once at creation. Kordio stores only a digest. This credential can ask for authorization and can never write policy.

Body

application/json
budget_id
string<uuid>
required
amount_ceiling_cents
integer
required

The most this token may authorize, in minor units.

Required range: x >= 1
Example:

20000

counterparty
string | null

Pins the token to one payee. A payment to anyone else is refused with spend_token_counterparty.

Example:

"acme-supplies.example"

expires_at
string<date-time> | null

Response

The minted token.

data
object
required