Skip to main content
DELETE
/
api
/
budgets
/
:id
curl -X DELETE https://api.yourfinanceapp.com/api/budgets/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 50000.0,
  "month": 1,
  "year": 2026,
  "categoryId": "660e8400-e29b-41d4-a716-446655440001",
  "userId": "770e8400-e29b-41d4-a716-446655440002"
}

​
Authentication

This endpoint requires JWT authentication via Bearer token.

​
Path Parameters

​
id
string
required
UUID of the budget to delete

​
Validation Rules

​
Ownership

You can only delete budgets you own. Error: 403 Forbidden - “No tienes permiso”

​
Not Found

Budget must exist. Error: 404 Not Found - “Presupuesto no encontrado”

​
Response

Returns the deleted budget object.
​
id
string
UUID of the deleted budget
​
amount
number
Budget limit amount
​
month
integer
Month of the budget (1-12)
​
year
integer
Year of the budget
​
categoryId
string
UUID of the associated category
​
userId
string
UUID of the user who owned this budget
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 50000.0,
  "month": 1,
  "year": 2026,
  "categoryId": "660e8400-e29b-41d4-a716-446655440001",
  "userId": "770e8400-e29b-41d4-a716-446655440002"
}

curl -X DELETE https://api.yourfinanceapp.com/api/budgets/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Important Notes

  • Deleting a parent category budget does not delete child budgets
  • Child categories become “orphaned” from the parent limit but remain valid
  • This operation is permanent and cannot be undone
  • Consider updating to amount 0 instead if you want to preserve historical data

Build docs developers (and LLMs) love

Get started for freeTalk to us