API reference · CAIN Budget

Evaluate Budget

POST /fabric/budgets/evaluate

Last reviewed 2026-10-02

POST /fabric/budgets/evaluate

Request body

EvaluateRequest (required)

Responses

Try it

The request goes from your browser straight to this site. Your key is not stored unless you tick the box, and then only in this tab's session storage.

Code

curl -sS -X POST 'https://cainstudio.online/fabric/budgets/evaluate' \
  -H "X-API-Key: $CAIN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"amount_cents": 1.0, "action": "action", "scope": "tenant"}'

import json, os, urllib.request

req = urllib.request.Request('https://cainstudio.online/fabric/budgets/evaluate', method='POST',
    headers={"X-API-Key": os.environ["CAIN_API_KEY"], "Content-Type": "application/json"},
    data=json.dumps({
      "amount_cents": 1.0,
      "action": "action",
      "scope": "tenant"
    }).encode())
with urllib.request.urlopen(req, timeout=60) as r:
    print(r.status, json.load(r))

const res = await fetch("https://cainstudio.online/fabric/budgets/evaluate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CAIN_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "amount_cents": 1.0,
    "action": "action",
    "scope": "tenant"
  }),
});
console.log(res.status, await res.json());

Schemas used

HTTPValidationError · ValidationError · EvaluateRequest

← Create Budget · all 13 CAIN Budget calls · Budget Health →