HomeGuidesAPI ReferenceChangelogDiscussions
API Reference
These docs are for v2.0. Click to read the latest docs for v2024-10-01.

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.
Who can use it?

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

Language
Credentials
URL
Click Try It! to start a request and see the response here!