The following macros are not currently supported in the header:
- style
Count Tasks
Resource URL
Returns the number of tasks in the system (filters apply)
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
GET /tasks/count.json
{
"response" : {
"count" : "265"
},
"meta" : {
"status" : "ok",
"message" : "Everything executed as expected."
}
}