Actions

Post actions

POST
Perform a Data Manager action with the selected tasks and filters.

Query parameters

idenumOptional
Action name ID, the full list of actions can be retrieved with a GET request
projectintegerOptional
Project ID
viewintegerOptional
View ID (optional, it has higher priority than filters, selectedItems and ordering from the request body payload)

Request

This endpoint expects an object.
filters
objectOptional

Filters to apply on tasks. You can use the helper class Filters from this page to create Data Manager Filters.
Example: {"conjunction": "or", "items": [{"filter": "filter:tasks:completed_at", "operator": "greater", "type": "Datetime", "value": "2021-01-01T00:00:00.000Z"}]}

selectedItems
unionOptional

Task selection by IDs. If filters are applied, the selection will be applied to the filtered tasks.If “all” is false, "included" must be used. If “all” is true, "excluded" must be used.
Examples: {"all": false, "included": [1, 2, 3]} or {"all": true, "excluded": [4, 5]}

ordering
list of enumsOptional

List of fields to order by. Fields are similar to filters but without the filter: prefix. To reverse the order, add a minus sign before the field name, e.g. -tasks:created_at.

POST
1curl -X POST http://localhost:8080/api/dm/actions/ \
2 -H "Authorization: Token <api_key>" \
3 -H "Content-Type: application/json" \
4 -d '{}'