Resource URL
Returns the number of tasks in the system (filters apply)
| Code Block |
|---|
|
GET /tasks/count
ANY /tasks/count?_method=get |
Parameters
Table of allowed parameters.
| _filters | partial string | Apply a filter to the counted objects. |
|---|
Filtering tasks
You can filter the returned list using the _filter parameter. You can stack filters. For example, _filter=assignee(21,3),against(company),manager(2,5)
| Name | Example | Description |
|---|
| assignee(id1,id2,idN) | assignee(12,3) | Only return tasks that are assigned to the specified staff id(s) |
| manager_id(id1,id2,idN) | manager_id(324) | Only return tasks that are managed by one of the specified staff id(s) |
| status(id1,id2,idN) | status(1,2,4) | Only return tasks at the specified status(es). |
| against(type1, type2, typeN) | against(company, issue) | Only return tasks that are against a specific object type. Available object types include: company, component, deployment, issue and prospect. That is, any object that can have a task against it. |
Handling the response
Below is a table of available response fields and objects that are returned within the response object of the returned object. The optional fields and objects can be requested in the _fields parameter; see included examples.
| count | unsigned int | The total number of objects found at the end of the resource. |
|---|
Sample Response
| Code Block |
|---|
|
GET /tasks/count.json |
...