Skip to main content
PATCH
/
budget
/
:id
curl -X PATCH https://api.homeaccount.com/budget/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-CSRF-Token: YOUR_CSRF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "123e4567-e89b-12d3-a456-426614174000",
    "amount": 60000,
    "alert_threshold": 90
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "123e4567-e89b-12d3-a456-426614174000",
    "category_id": "987fcdeb-51a2-43d7-9f12-345678901234",
    "amount": 60000,
    "period": "monthly",
    "alert_threshold": 90,
    "created_at": "2026-03-05T10:30:00.000Z",
    "updated_at": "2026-03-05T11:45:00.000Z"
  }
}
Updates the amount, period, or alert threshold of an existing budget. Note that the category cannot be changed - to budget a different category, create a new budget.

​
Path Parameters

​
id
string
required
The UUID of the budget to update

​
Request Body

​
account_id
string
required
The UUID of the account this budget belongs to. Used for verification.
​
amount
number
The new budget amount in cents. Must be a positive integer between 1 and 90000000 (900,000€)
​
period
string
The new budget period. Must be one of:
  • weekly - Budget resets every week
  • monthly - Budget resets every month
  • yearly - Budget resets every year
​
alert_threshold
number
The new percentage at which to trigger spending alerts. Must be between 50 and 100.

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The updated budget object
curl -X PATCH https://api.homeaccount.com/budget/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-CSRF-Token: YOUR_CSRF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "123e4567-e89b-12d3-a456-426614174000",
    "amount": 60000,
    "alert_threshold": 90
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "123e4567-e89b-12d3-a456-426614174000",
    "category_id": "987fcdeb-51a2-43d7-9f12-345678901234",
    "amount": 60000,
    "period": "monthly",
    "alert_threshold": 90,
    "created_at": "2026-03-05T10:30:00.000Z",
    "updated_at": "2026-03-05T11:45:00.000Z"
  }
}

​
Error Codes

  • 400 - Invalid request parameters
  • 401 - Missing or invalid authentication token
  • 403 - Invalid CSRF token
  • 404 - Budget not found or does not belong to the specified account
  • 500 - Internal server error

​
Notes

  • All fields except account_id are optional. Only provided fields will be updated.
  • The category_id cannot be changed. To budget a different category, create a new budget.
  • The updated_at timestamp is automatically updated when any changes are made.

Build docs developers (and LLMs) love

Get started for freeTalk to us