Update a budget

PATCH 
/api/budgets/{id}

Required permissions:

• budget.edit: allows editing budgets where the user is the PM or the Account.
• budget.edit_other: allows editing budgets where the user is not the PM nor the Account.

Here the dedicated support page.

Request

Path Parameters

id integerrequired

Possible values: Value must match regular expression [0-9]+

The ID of the budget to update

Header Parameters

Wethod-Company stringrequired

The company you want to interact with

Wethod-Version stringrequired

The API version you want to use

application/json

Body

price_list_id integer

The ID of the price list to associate with this budget

final_net_price number

The final net price of the budget in the master currency

final_net_price_currency number

The final net price of the budget in the budget currency

currency_enabled boolean

Whether multicurrency is enabled for the budget

currency string

The currency code for the budget

notes string

Notes about the budget

Responses

200

Returns the updated budget.

application/json

Schema

Schema

id integerrequired

Possible values: >= 1

The unique identifier of the resource

created_at date-timerequired

The date and time when the resource was created

updated_at date-timerequired

The date and time when the resource was last updated

project_id integerrequired

Possible values: >= 1

The ID of the project this budget belongs to

price_list_id integerrequired

Possible values: >= 1

The ID of the price list this budget belongs to

version integerrequired

The version of the budget

status stringrequired

Possible values: [DRAFT, SUBMITTED, APPROVED]

The status of the budget

final_net_price floatrequired

The final net price of the budget in the master currency

final_net_price_currency float

The final net price of the budget in the budget currency

total_external_cost floatrequired

The total external costs of the budget

total_cost floatrequired

The total cost of the budget

total_price floatrequired

The total price of the budget

total_days floatrequired

The total days of the budget

is_baseline booleanrequired

Whether this budget version is the baseline

notes stringrequired

The budget notes

currency string

The currency code

is_currency_enabled booleanrequired

Whether custom currency is enabled

Example (from schema)

{
  "id": 1,
  "created_at": "2025-06-06T13:37:10.550Z",
  "updated_at": "2025-06-06T13:37:10.550Z",
  "project_id": 1,
  "price_list_id": 1,
  "version": 1,
  "status": "APPROVED",
  "final_net_price": 12000,
  "final_net_price_currency": 12000,
  "total_external_cost": 14400,
  "total_cost": 10000,
  "total_price": 15000,
  "total_days": 20.5,
  "is_baseline": false,
  "notes": "Important budget",
  "currency": "EUR",
  "is_currency_enabled": false
}

400

Validation failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

failures

object[]

List of validation errors

Array [

field string

Name of the field causing the error

message string

Human-readable description of the error

]

Example (from schema)

{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

403

Forbidden

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

404

Not found

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "not_found",
  "message": "string"
}

Loading...