Skip to main content
GET
/
project-roles
/
{id}
Get a project role
curl --request GET \
  --url https://www.ruddr.io/api/workspace/project-roles/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3e7a1b2c-8f4d-4a9e-b6c3-d2f5a8e1c9b7",
  "name": "Senior Engineer",
  "isActive": true,
  "isBillable": true,
  "rate": 175,
  "createdAt": "2025-03-12T14:22:08.500Z",
  "discipline": {
    "id": "a91f4c2d-73b5-4e6a-8d1c-f3e7b2a9c4d6",
    "name": "Engineering"
  },
  "practice": {
    "id": "c45d8e3f-12a7-4b9c-9e2d-7f6a1b3c8d5e",
    "name": "Software Development"
  },
  "location": {
    "id": "f2b7c9a4-85d3-4f1e-a6b8-c3d9e7f2a1b4",
    "name": "New York"
  },
  "project": {
    "id": "d8e3f7a2-c1b9-4d6e-8f2a-b5c7d3e9f1a6",
    "name": "Platform Modernization",
    "client": {
      "id": "e1a4b8c3-d7f2-4e9a-b6c1-a3d8f4e7b2c9",
      "name": "Acme Corporation"
    }
  },
  "budget": {
    "billableHours": 320,
    "nonBillableHours": 40
  },
  "monthlyBudget": {
    "billableHours": 80,
    "nonBillableHours": 10
  }
}
A role on a project used to group rates and billability settings, then assigned to project members.

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 role uuid

Response

200

​
id
string

The unique identifier for the object.

​
name
string

The name of the role (max 255 chars).

​
isActive
boolean

Whether the role is still active on the project.

​
isBillable
boolean

Whether the role is billable. Defaults to the project's billability and is overridden to false if the project is non-billable.

​
rate
number | null

The billing rate for this role. null when the role or project is non-billable.

​
createdAt
string<date-time>

The timestamp when the object was created.

​
discipline
object

The discipline associated with this role. null if not assigned.

​
practice
object

The practice associated with this role. null if not assigned.

​
location
object

The location associated with this role. null if not assigned.

​
project
object

The project this role belongs to.

​
budget
object

The budget hours for this role. null when the project does not use a budget.

​
monthlyBudget
object

The monthly budget hours for this role. null when the project does not use a monthly budget in detailed mode.