POST /api/v1/bulk-actions/execute
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string
application/json

Body

  • type 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.

    Value Description
    tasks_complete Complete Tasks
    tasks_archive Archive Tasks
    tasks_delete Delete Tasks
    tasks_attach Attach Assignee To Tasks
    tasks_detach Detach Assignee From Tasks
    tasks_sync Sync Assignees On Tasks
    tasks_priority Prioritise Tasks
    tasks_status Update Status On Tasks
    tasks_taskable Update Taskable On Tasks
    tasks_due_date Update Due Date On Tasks

    Values are tasks_complete, tasks_archive, tasks_delete, tasks_attach, tasks_detach, tasks_sync, tasks_priority, tasks_status, tasks_taskable, or tasks_due_date.

  • is_recursive boolean

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

  • items array 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 object

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

    Hide filters attributes Show filters attributes object
    • taskable_uuid string(uuid)

      Filter by uuid

    • taskable_type string

      Taskable type

      Values are client, case, or plan.

  • data object

    Optional data reserved for specific bulk action requirements.

    Additional properties are allowed.

Responses

  • 200 application/json
POST /api/v1/bulk-actions/execute 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/bulk-actions/execute' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"type":"tasks_complete","is_recursive":true,"items":["669c7fb6-215f-44bf-bafc-abe08194b8ef","0fe7b62c-16a6-4320-b7c8-91690b1bb75e"],"filters":{"taskable_type":"client","taskable_uuid":"ee7351f5-e6eb-43e9-8ed4-f8bb145401e5"},"data":{}}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "type": "tasks_complete",
  "is_recursive": true,
  "items": [
    "669c7fb6-215f-44bf-bafc-abe08194b8ef",
    "0fe7b62c-16a6-4320-b7c8-91690b1bb75e"
  ],
  "filters": {
    "taskable_type": "client",
    "taskable_uuid": "ee7351f5-e6eb-43e9-8ed4-f8bb145401e5"
  },
  "data": {}
}
Response examples (200) 
{}