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

_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

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