API reference · schema

ReserveRequest

6 fields · used by 1 operations

Last reviewed 2026-10-03

Fields

Field	Type	Meaning
`amount_cents` required	number	> `0.0`
`action` required	string	min length `1`
`trace_id`	string or null
`decision_id`	string or null
`ttl_seconds`	integer	min `1.0` · max `3600.0` · default `300`
`idempotency_key`	string or null

Smallest valid example

{
  "amount_cents": 1.0,
  "action": "action",
  "ttl_seconds": 300
}

Used by 1 operation

POST /fabric/budgets/{budget_id}/reserve Reserve Budget

JSON Schema

Show the raw definition

{
  "properties": {
    "amount_cents": {
      "type": "number",
      "exclusiveMinimum": 0.0,
      "title": "Amount Cents"
    },
    "action": {
      "type": "string",
      "minLength": 1,
      "title": "Action"
    },
    "trace_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trace Id"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Decision Id"
    },
    "ttl_seconds": {
      "type": "integer",
      "maximum": 3600.0,
      "minimum": 1.0,
      "title": "Ttl Seconds",
      "default": 300
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Idempotency Key"
    }
  },
  "type": "object",
  "required": [
    "amount_cents",
    "action"
  ],
  "title": "ReserveRequest"
}

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.

Create a free account → · Try the sandbox · See the whole ecosystem