Execute a bulk action

POST /api/v1/bulk-actions/execute

Headers

application/json

Body Required

  • name string

    The name of the bulk action to perform. Options:tasks_complete, tasks_archive, tasks_delete, tasks_attach, tasks_detach, tasks_sync, tasks_priority, tasks_status, tasks_taskable and tasks_due_date. * "tasks_complete" allows for the mass completion of tasks. * "tasks_delete" allows for the mass deletion of tasks. * "tasks_sync" is intended for syncing the chosen tasks with the selected accounts (This will overwrite any members previously selected with the newly chosen members.). * "tasks_attach" is intended for attaching the chosen members to the selected tasks. * "tasks_detach" is intended for detaching the chosen members from the selected tasks. * "tasks_archive" is intended for archiving the chosen tasks.

  • is_recursive boolean

    Only used for task bulk actions, whether to perform the bulk action recursively over all sub-tasks.

  • items array[string] Required

    The items to perform the bulk action on. Send an array with a single * value instead of an array to select all items. Use filter to constrain all items.

  • filters array[string]

    The filters to apply to the bulk action. These can only be used on a catch-all bulk action.

  • data array[string]

    Optional data reserved for specific bulk action requirements.

Responses

POST /api/v1/bulk-actions/execute 
curl \
 -X POST https://api.plannrcrm.com/api/v1/bulk-actions/execute \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 -d '{"name":"Complete","is_recursive":true,"items":["67675a30-c2d4-4462-81a0-f893719f60e3","c747b75a-4d5c-4f41-85bf-8e6abc3d0dac"],"filters":["related_items","taskable_uuid"],"data":["string"]}'
Request examples 
# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Complete",
  "is_recursive": true,
  "items": [
    "67675a30-c2d4-4462-81a0-f893719f60e3",
    "c747b75a-4d5c-4f41-85bf-8e6abc3d0dac"
  ],
  "filters": [
    "related_items",
    "taskable_uuid"
  ],
  "data": [
    "string"
  ]
}
Response examples (200) 
{}