API reference · CAIN Budget

Create Budget

POST /fabric/budgets

Last reviewed 2026-10-02

POST /fabric/budgets

Request body

CreateBudgetRequest (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' \
  -H "X-API-Key: $CAIN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name": "name", "description": "", "scope": "tenant", "limit_cents": 1.0, "period": "monthly", "hard_limit": true, "soft_limit_pct": 80.0, "alert_threshold_pct": 50.0, "currency": "USD"}'

import json, os, urllib.request

req = urllib.request.Request('https://cainstudio.online/fabric/budgets', method='POST',
    headers={"X-API-Key": os.environ["CAIN_API_KEY"], "Content-Type": "application/json"},
    data=json.dumps({
      "name": "name",
      "description": "",
      "scope": "tenant",
      "limit_cents": 1.0,
      "period": "monthly",
      "hard_limit": True,
      "soft_limit_pct": 80.0,
      "alert_threshold_pct": 50.0,
      "currency": "USD"
    }).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", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CAIN_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "name",
    "description": "",
    "scope": "tenant",
    "limit_cents": 1.0,
    "period": "monthly",
    "hard_limit": true,
    "soft_limit_pct": 80.0,
    "alert_threshold_pct": 50.0,
    "currency": "USD"
  }),
});
console.log(res.status, await res.json());

Schemas used

CreateBudgetRequest · HTTPValidationError · ValidationError

← List Budgets · all 13 CAIN Budget calls · Evaluate Budget →