Skip to main content
POST
/
project-monthly-budget-expenses
Create a project monthly budget expense
curl --request POST \
  --url https://www.ruddr.io/api/workspace/project-monthly-budget-expenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "expenseCategoryId": "<string>",
  "billableAmount": 123,
  "nonBillableAmount": 123,
  "notes": "<string>"
}
'
{
  "id": "3c7f2b91-44a8-4e6d-b105-82d9c0f71e3a",
  "billableAmount": 2500,
  "nonBillableAmount": 750,
  "createdAt": "2025-06-10T14:32:45.871Z",
  "notes": "Monthly travel and accommodation budget for on-site work.",
  "expenseCategory": {
    "id": "9a1d5e04-fc83-4c27-b7e2-d3a60b88c215",
    "name": "Travel"
  },
  "project": {
    "id": "b84e6c37-291f-4a50-9d78-15f0e3c92b46",
    "name": "Acme Platform Redesign",
    "client": {
      "id": "e2a73d58-06b4-47f9-a831-c95d04e17f28",
      "name": "Acme Company, Inc."
    }
  }
}
The monthly budget for an expense category on a project. Only available for projects that are using a monthly budget and the monthly budget mode is “detailed”.

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 of the project to associate with this budget entry (UUID).

​
expenseCategoryId
string
required

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

​
billableAmount
number | null

The total billable amount for this expense category.

​
nonBillableAmount
number | null

The total non-billable amount for this expense category.

​
notes
string | null

Notes about this monthly 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.

​
notes
string | null

Notes about this monthly budget expense.

​
expenseCategory
object

The expense category associated with this budget entry.

​
project
object

The project associated with this budget entry.