API Reference / Finance - Budgets

Update budget

put https://api.intelig.ai/api/v1/intelig/budgets/{budgetId}

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: updateBudget

Updates budget name, description, or status

Example request

curl -X PUT "https://api.intelig.ai/api/v1/intelig/budgets/1" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 2026 Engineering Budget (Revised)",
    "description": "Revised engineering headcount budget",
    "status": "ACTIVE"
  }'

Path parameters

NameTypeRequiredDescription
budgetId integer (int64) yes

Request body

application/json

FieldTypeRequiredDescription
name string yes Updated budget name Example: Q1 2026 Engineering Budget (Revised)
description string no Updated budget description Example: Revised engineering headcount budget
status string no Updated budget status One of: DRAFT, ACTIVE, ARCHIVED Example: ACTIVE

Response 200

application/json · ApiResponseVoid

FieldTypeDescription
success boolean
message string
data object

Status codes

  • 200 — Budget updated successfully
  • 400 — Invalid request body
  • 401 — Not authenticated
  • 403 — Insufficient permissions to access finance pillar
  • 404 — Budget not found
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.