Introduction
Tasks are useful for managing small pieces of work related to a specific item, hence you'll find the purple Tasks box on an issue, prospect, company and component view screen.
Resource Endpoints
| METHOD | ENDPOINT | DescriptionDESCRIPTION |
|---|---|---|
| PUT | tasks/:id | Update a task identified by task_id. |
| POST | /tasks | Creates a new task. |
| GET | tasks | Returns an array of tasks. |
| GET | tasks/count | Returns the number of tasks in the system. |
| GET | tasks/:id | Returns a task identified by task_id. |
Define filters in the _filters parameter.
| status | e.g _filters=status(3,5) | |
|---|---|---|
| manager | e.g _filters=against(1012) | |
| assignee | e.g _filters=assignee(102,10) | |
| against | e.g _filters=against(company(1,43,2),issue(12)) | |
| against_type | e.g, _filters=against_type(company) | |
| against_id | e.g, _filters=against_id(12,42)||
PUT or POST | Auto progress a task to either the "start" (started status) or "done" (completed status). | |
| GET | /tasks/:id/progressions | Returns an array of available progressions for the task. |
| [PUT|POST] | /tasks/:id/progressions/:progression_id/auto | Runs a status update for the given progression on the given task. |
| GET | /tasks/statuses | Returns an array of available task statuses |