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",
  "parent": {
    "id": "7d1b4f93-2a85-4c70-8e16-5b29d4c7e831",
    "name": "Phase 2 Development"
  },
  "project": {
    "id": "f52e9a17-3c64-4b88-a701-8d94bc2f5e63",
    "name": "Acme Portal Redesign",
    "client": {
      "id": "2b7d8e41-9f53-4a26-b8c2-6e1f5d3a9074",
      "name": "Acme Company, Inc."
    }
  },
  "roles": [
    {
      "id": "0e011217-4925-4931-b2ee-257da8d9f0fe",
      "name": "Senior Developer",
      "hours": 80
    },
    {
      "id": "c4a9f312-8b57-4d93-a625-1e7f2b8d4c06",
      "name": "QA Engineer",
      "hours": 40.5
    }
  ],
  "tags": [
    {
      "id": "91b3e724-5f18-4a92-8c37-2d6e4f1b5a89",
      "name": "Backend"
    },
    {
      "id": "3e8f1d62-7a45-4b19-9c28-6f2e5d4a3b17",
      "name": "High Priority"
    }
  ],
  "projectMembers": [
    {
      "id": "5c2d9f84-1b67-4e38-a915-7d3c8e2f6a41",
      "member": {
        "id": "b8f4e293-6d17-4a85-9c42-3e7f1d5b2a68",
        "name": "Jordan Rivera"
      },
      "hours": null
    }
  ]
}
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 (max 255 chars).

notes
string | null

Any notes associated with the task (max 5000 chars).

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, defaults to not_started if not set.

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, defaults to true if not set. Will be overridden to false if 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 (max 255 chars).

forAssignedOnly
boolean

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

requireNotes
boolean

Requires notes on time entries for this task. Will be overridden to true if the project requires notes.

recordStatusId
enum<string>

The record status of the task, defaults to active if not set.

Available options:
active,
archived
budgetedHours
number | null

The budgeted hours for the task. Only used if there are no roles or project members set.

budgetedServicesRevenue
number | null

The budgeted services revenue for the task. Only used if there are no roles or project members set.

createdAt
string<date-time>

The timestamp when the object was created.

parent
object

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

project
object

The project this task belongs to.

roles
object[] | null

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

tags
object[]

The list of tags associated with this task.

projectMembers
object[]

The list of project members directly assigned to this task. IDs must be unique.