Create or update a workspace budget

Create or update the budget for a given interval. Budget limits must strictly decrease as the interval narrows (lifetime > monthly > weekly > daily). Management key required.

put/workspaces/{id}/budgets/{interval}

Path parameters

idstring required

The workspace ID (UUID) or slug

Example:production

The workspace ID (UUID) or slug

interval'daily' | 'weekly' | 'monthly' | 'lifetime' required

Budget reset interval. Use "lifetime" for a one-time budget that never resets.

Example:monthly

Budget reset interval. Use "lifetime" for a one-time budget that never resets.

Request body

limit_usdnumber double required

Spending limit in USD. Must be greater than 0.

Example request

{
  "limit_usd": 100
}

Response

Budget created or updated successfully

Example response

{
  "data": {
    "created_at": "2025-08-24T10:30:00Z",
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "limit_usd": 100,
    "reset_interval": "monthly",
    "updated_at": "2025-08-24T15:45:00Z",
    "workspace_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}