/
Count Tasks
The following macros are not currently supported in the header:
  • style

Count Tasks

Feb 29, 2016

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.

_filterspartial stringApply 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)

NameExampleDescription
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.

countunsigned intThe 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."
   }
}