Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
ProjectManagement > ProjectTask

Reads a single Project task

What does it do?

This reads the data of projects tasks, and retrieves the information based on permissions:

  • If the user can see all company projects for everybody, the endpoint will return a list with the tasks from the related projects.
  • If the user can create projects for everybody, the endpoint will return a list with the tasks from the related projects.
  • If the user has any role (editor or owner) on the project, the endpoint will return a list with the tasks from the related projects where the user has that role.
  • If those conditions are not matched, the endpoint will return an empty list.
What params does it accept?
  • ids: retrieve only the projects tasks that matches the ids passed in the request.
  • project_ids: retrieve only the projects tasks from the projects that matched the ids passed in the request.
  • subproject_ids: retrieve only the projects tasks from the subprojects that matched the ids passed in the request.
  • completed: boolean - retrieve only the projects tasks with the status completed.
  • overdue: boolean - retrieve only the projects tasks that are overdue.
  • search: retrieve only the projects tasks that their name match with the content passed as argument.
  • due_status: retrieve only the project tasks that their due status match with the content passed as argument.
  • client_ids: retrieve only the projects tasks from the clients that matched the ids passed in the request.
Who can use it?

Only companies who have enabled the projects_management feature and users with the permission of read projects.

get/api/2026-07-01/resources/project_management/project_tasks/{id}

Path parameters

idstring required

Retrieve only the projects tasks that matches the ids passed in the request.

Response

OK

idstring required
project_idstring required

The ID of the project linked to the project task

subproject_idstring

The ID of the subproject linked to the project task

task_idstring required

The ID of the task linked to the project task

follow_upboolean required

If true, status changes related to the project will notify the author

Example response

{
  "id": "789",
  "project_id": "123",
  "subproject_id": "456",
  "task_id": "780",
  "follow_up": true
}