Skip to main content
PATCH
/
project-budget-expenses
/
{id}
Update a project budget expense
curl --request PATCH \
  --url https://www.ruddr.io/api/workspace/project-budget-expenses/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "billableAmount": 123,
  "nonBillableAmount": 123,
  "notes": "<string>",
  "expenseCategoryId": "<string>"
}
'
{
  "id": "c8f42e17-a593-4d0b-b6e1-d2a70f8c39e5",
  "billableAmount": 3000,
  "nonBillableAmount": 500,
  "createdAt": "2026-01-20T16:08:44.561Z",
  "project": {
    "id": "e1b73d24-9f06-4a8c-85e2-c0d4f7a18b93",
    "name": "Data Analytics Platform",
    "client": {
      "id": "7f2a8c91-e304-4b5d-a6e1-d9c0f3b72e48",
      "name": "Initech"
    }
  },
  "expenseCategory": {
    "id": "b4e91c27-3f08-4d6a-a5e2-c7d0f8b13a96",
    "name": "Travel Expenses"
  }
}
The budget for an expense category on a project. Only available for projects that are using a budget and the budget mode is either “detailed” or “aggregated”.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The project budget expense uuid.

Body

application/json
​
billableAmount
number | null

The total billable amount for the expense category.

​
nonBillableAmount
number | null

The total non-billable amount for the expense category.

​
notes
string | null

Notes about this budget expense. Maximum 5000 characters.

​
expenseCategoryId
string

The ID (uuid) of the expense category for this budget expense.

Response

200

​
id
string

The unique identifier for the object.

​
billableAmount
number | null

The total billable amount for the expense category. null when the project is non-billable.

​
nonBillableAmount
number | null

The total non-billable amount for the expense category.

​
createdAt
string<date-time>

The timestamp when the object was created.

​
project
object

The project this budget expense belongs to.

​
expenseCategory
object

The expense category for this budget expense.