Budget API

Budget management at organization, workspace, and project levels. Tracks AI agent execution costs and enforces spending limits.

Budget Hierarchy: Organization → Workspace → Project

TIP

For organization-level budget with workspace breakdown, see the Organizations API — Budget.

Workspace Budget

Get Budget

GET /api/v1/workspaces/{workspace_id}/budget
Authorization: Bearer <token>

Response 200 OK

{
  "workspace_id": "uuid",
  "budget_monthly_limit_usd": 500.0,
  "budget_used_usd": 127.45,
  "budget_alert_threshold": 0.8,
  "usage_percent": 0.255,
  "period_start": "2026-05-01T00:00:00Z"
}

Reset Budget

Resets the used amount to $0. Requires admin role.

POST /api/v1/workspaces/{workspace_id}/budget/reset
Authorization: Bearer <token>

Project Budget

Get Budget

GET /api/v1/projects/{project_id}/budget
Authorization: Bearer <token>

Response 200 OK

{
  "project_id": "uuid",
  "budget_limit_usd": 200.0,
  "budget_used_usd": 45.30,
  "usage_percent": 0.227
}

Reset Budget

Requires admin role on the workspace.

POST /api/v1/projects/{project_id}/budget/reset
Authorization: Bearer <token>