Bulk update tasks - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Completion statuses invoke task completion and may advance sequence workflows; task deletion means marking matching tasks skipped and emitting their status effects. Selection is capped at 5,000 matching tasks.

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.
status · optional
string
New task status: pending, scheduled, completed, failed, or skipped.
priority · optional
string
New priority level.
assigned_to · optional
string
New assignee user ID.
due_date · optional
string (ISO datetime)
New due date.
task_group_id · optional
string
New task group ID.
outcome · optional
string
Completion outcome (used when status is completed/skipped/failed).

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.
status	string	New task status: pending, scheduled, completed, failed, or skipped.
priority	string	New priority level.
assigned_to	string	New assignee user ID.
due_date	string (ISO datetime)	New due date.
task_group_id	string	New task group ID.
outcome	string	Completion outcome (used when status is completed/skipped/failed).

Errors

Status	Meaning
400	No update fields provided, 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-update" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"task_ids":["67c4d064b4dd8f2d4999f611"],"status":"completed"}'

Request body

json

{
    "task_ids": ["67c4d064b4dd8f2d4999f611", "67c4d064b4dd8f2d4999f612"],
    "status": "completed",
    "outcome": "interested"
  }

Response example

json

{
    "success": true,
    "matched_count": 2,
    "updated_count": 2,
    "message": "Successfully updated 2 tasks"
  }