Skip to main content
GET
/
project-tasks
/
{id}
Get a project task
curl --request GET \
  --url https://www.ruddr.io/api/workspace/project-tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "a3f8c214-7b92-4e61-9d05-1c83e6f2a047",
  "name": "Backend API Integration",
  "notes": "Implement REST endpoints for the client portal module.",
  "order": 16384,
  "position": 16384,
  "statusId": "in_progress",
  "start": "2026-02-01",
  "end": "2026-03-31",
  "isBillable": true,
  "lockTime": false,
  "capHours": true,
  "capAssignedHours": false,
  "code": "DEV-042",
  "forAssignedOnly": false,
  "requireNotes": false,
  "recordStatusId": "active",
  "budgetedHours": 120.5,
  "budgetedServicesRevenue": 18075,
  "createdAt": "2026-01-10T14:22:35.491Z",
  "project": {
    "id": "f52e9a17-3c64-4b88-a701-8d94bc2f5e63",
    "name": "Acme Portal Redesign",
    "client": {
      "id": "2b7d8e41-9f53-4a26-b8c2-6e1f5d3a9074",
      "name": "Acme Company, Inc."
    }
  },
  "parent": {
    "id": "7d1b4f93-2a85-4c70-8e16-5b29d4c7e831",
    "name": "Phase 2 Development"
  },
  "roles": [
    {
      "id": "0e011217-4925-4931-b2ee-257da8d9f0fe",
      "name": "Senior Developer",
      "hours": 80
    },
    {
      "id": "c4a9f312-8b57-4d93-a625-1e7f2b8d4c06",
      "name": "QA Engineer",
      "hours": 40.5
    }
  ],
  "projectMembers": [
    {
      "id": "5c2d9f84-1b67-4e38-a915-7d3c8e2f6a41",
      "member": {
        "id": "b8f4e293-6d17-4a85-9c42-3e7f1d5b2a68",
        "name": "Jordan Rivera"
      },
      "hours": null
    }
  ],
  "tags": [
    {
      "id": "91b3e724-5f18-4a92-8c37-2d6e4f1b5a89",
      "name": "Backend"
    },
    {
      "id": "3e8f1d62-7a45-4b19-9c28-6f2e5d4a3b17",
      "name": "High Priority"
    }
  ]
}
A work item or activity that helps complete a project.

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 task uuid.

Response

200

id
string

The unique identifier for the object.

name
string

The name of the task.

notes
string | null

Any notes associated with the task.

order
integer

The display order position of the task (same value as position).

position
integer

The numeric position of the task used for ordering.

statusId
enum<string>

The status of the task.

Available options:
not_started,
in_progress,
completed
start
string<date> | null

The start date for the task. Will be in the form YYYY-MM-DD.

end
string<date> | null

The end date for the task. Will be in the form YYYY-MM-DD. null if no end date is set.

isBillable
boolean

Whether the task is billable. Overridden to false when the project is not billable.

lockTime
boolean

When enabled, prevents new time entries from being created with this task.

capHours
boolean

When enabled, prevents time entries that would exceed the budgeted hours for this task.

capAssignedHours
boolean

When enabled, prevents time entries that would exceed the budgeted hours assigned to the role or member for this task.

code
string | null

The project task code.

forAssignedOnly
boolean

When enabled, only assigned members and roles can track time to this task.

requireNotes
boolean

Whether notes are required on time entries for this task. Overridden to true when the project requires notes.

recordStatusId
enum<string>

The record status of the task.

Available options:
active,
archived
budgetedHours
number | null

The budgeted hours for the task.

budgetedServicesRevenue
number | null

The budgeted services revenue for the task.

createdAt
string<date-time>

The timestamp when the object was created.

project
object

The project this task belongs to.

parent
object

The parent task this task is nested under, or null if it has no parent.

roles
object[] | null

The list of project roles assigned to this task. null when the project does not use roles.

projectMembers
object[]

The list of project members directly assigned to this task.

tags
object[]

The list of tags associated with this task.