Bulk delete tasks

Soft-delete tasks (mark as skipped) using explicit IDs or a descriptor selection.

POST/api/task-queue/bulk-delete

HTTP referenceScope tasks:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This is a soft delete: matching tasks are completed with status skipped; status events are emitted and lead next-activity summaries are refreshed. It does not physically remove task records.

Query parameters

actorUserId · optional
string
Optional actor override.

Name	Type	Description
actorUserId	string	Optional actor override.

Body parameters

task_ids · optional
array<string>
Explicit task IDs. Provide either task_ids or selection.
selection · optional
object
Bulk selection object with mode (ids or descriptor), descriptor filter, search, etc.

Name	Type	Description
task_ids	array<string>	Explicit task IDs. Provide either task_ids or selection.
selection	object	Bulk selection object with mode (ids or descriptor), descriptor filter, search, etc.

Errors

Status	Meaning
400	Invalid task IDs or selection exceeds limit.
401	Invalid API key or missing auth.
403	Missing tasks:write scope.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/bulk-delete" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"task_ids":["67c4d064b4dd8f2d4999f611","67c4d064b4dd8f2d4999f612"]}'

Request body

json

{
    "task_ids": ["67c4d064b4dd8f2d4999f611", "67c4d064b4dd8f2d4999f612"]
  }

Response example

json

{
    "success": true,
    "matched_count": 2,
    "deleted_count": 2,
    "message": "Successfully deleted 2 tasks"
  }