Reads all Project tasks

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids[]
array of integers
required

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

ids[]*
project_ids[]
array of integers
required

Retrieve only the projects tasks from the projects that matched the ids passed in the request.

project_ids[]*
subproject_ids[]
array of integers
required

Retrieve only the projects tasks from the subprojects that matched the ids passed in the request.

subproject_ids[]*
task_ids[]
array of integers
task_ids[]
boolean
required

Retrieve only the projects tasks with the status completed.

boolean
required

Retrieve only the projects tasks that are overdue.

string
required

Retrieve only the projects tasks that their name match with the content passed as argument.

string
enum
required

Retrieve only the project tasks that their due status match with the content passed as argument.

Allowed:
client_ids[]
array of integers
required

Retrieve only the projects tasks from the clients that matched the ids passed in the request.

client_ids[]*
Response

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json