Manage and set up budgets for your service costs

Set up and manage budgets for your service costs. You can specify a monthly budget and a threshold for when you want to receive a notification that you are approaching the budget limit. This helps you keep track of your expenses.

Billing & Payments Billing

Context

Used in the dashboard

/cost-management

Headers

Accept Example
Content-Type Example

Body

required
application/json
alert_threshold integer required · Example: 80
annual_budget integer required · Example: 1200
monthly_budget integer required · Example: 39

Responses

200
data object required
data.budget object required
data.budget.active boolean required · Example: true
data.budget.alert_threshold integer required · Example: 80
data.budget.annual_budget string · nullable · enum required · Example: 1200.00

Nullable: may be null when not applicable.

1200.00
170.00
20000.00
6000.00
700.00
720.00
data.budget.client_id string required · Example: 30000
data.budget.created_at string required · Example: 2026-02-10T00:00:00.000Z
data.budget.email string · nullable required · Example: null

Nullable: may be null when not applicable.

data.budget.id integer required · Example: 68
data.budget.last_alerted string · nullable required · Example: 2026-02-10T00:00:00.000Z

Nullable: may be null when not applicable.

data.budget.monthly_budget string · nullable · enum required · Example: 39.00

Nullable: may be null when not applicable.

-1.00
1.00
100.00
15.00
150.00
2000.00
39.00
50.00
500.00
60.00
66.00
720.00
data.budget.updated_at string required · Example: 2026-02-10T00:00:00.000Z
data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/cost-management/budget
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/cost-management/budget" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "monthly_budget": 39,
    "annual_budget": null,
    "alert_threshold": 80
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "budget": {
      "id": 68,
      "client_id": "30000",
      "monthly_budget": "39.00",
      "annual_budget": null,
      "alert_threshold": 80,
      "email": null,
      "active": true,
      "last_alerted": null,
      "created_at": "2026-02-10T00:00:00.000Z",
      "updated_at": "2026-02-10T00:00:00.000Z"
    }
  }
}
Request Body Example 1 
{
  "monthly_budget": 39,
  "annual_budget": null,
  "alert_threshold": 80
}