Skip to main content
POST
/
project-budget-expenses
Create a project budget expense
curl --request POST \
  --url https://www.ruddr.io/api/workspace/project-budget-expenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "expenseCategoryId": "<string>",
  "billableAmount": 123,
  "nonBillableAmount": 123,
  "notes": "<string>"
}
'
{
  "id": "f29c3d71-8a45-4b0e-96e1-d5b7a2c84f03",
  "billableAmount": 3200,
  "nonBillableAmount": 800,
  "createdAt": "2026-02-10T14:25:33.718Z",
  "project": {
    "id": "71e4b903-2c68-4f1a-a5d9-b0f37e8c2d16",
    "name": "Mobile App Development",
    "client": {
      "id": "9a3f6c12-e758-40b4-d2a1-c8e5b7f09d34",
      "name": "Globex Industries"
    }
  },
  "expenseCategory": {
    "id": "e7b21c84-3f09-4a6d-815e-d9c4f0a72b53",
    "name": "Software Licenses"
  }
}
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.

Body

application/json
​
projectId
string
required

The ID (uuid) of the project this budget expense belongs to.

​
expenseCategoryId
string
required

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

​
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.

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.