Skip to main content
POST
Open a budget

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_cents
integer
required

The ceiling for this run, in minor units. Refused with budget_ceiling if it exceeds the agent's max_budget_cents, and with parent_budget_exhausted if a parent is named and has less than this left.

Required range: x >= 1
Example:

50000

currency
string
default:USD
Example:

"USD"

parent_budget_id
string<uuid> | null

Delegates from an existing session belonging to the same agent.

Response

The open session.

data
object
required