Exit sequences for selected tasks

This page documents the canonical HTTP contract for this endpoint.

Use a signed-in user session. Developer API keys are blocked for this route. Records are scoped to the current organization.

The selection must contain tasks linked to a sequence and Lead. Local exit, skipped-task, and Lead updates are represented by the returned counts. Provider pause work is durably admitted with the local exit, and returned operations entries contain job_id and operation_run_id. An admission receipt is not proof that the external provider pause has completed; follow each canonical operation run. The operations list may be empty when no provider pause is needed.

Query parameters

actorUserId · optional
string
Optional active same-organization actor override.

Name	Type	Description
actorUserId	string	Optional active same-organization actor override.

Body parameters

selection · optional
object
BulkSelectionModel: mode=ids with ids or mode=descriptor with descriptor. Use selection or task_ids.
task_ids · optional
array<string>
Explicit task IDs when selection is omitted.
lead_status · optional
string
Lead status to apply; defaults to nurture and must be a valid Lead status.

Name	Type	Description
selection	object	BulkSelectionModel: mode=ids with ids or mode=descriptor with descriptor. Use selection or task_ids.
task_ids	array<string>	Explicit task IDs when selection is omitted.
lead_status	string	Lead status to apply; defaults to nurture and must be a valid Lead status.

Errors

Status	Meaning
400	Invalid Lead status, task IDs, selection limit, or selected tasks are not sequence-linked.
401	A signed-in user session is required.
403	Developer API keys are blocked or the actor override is unavailable.
404	No tasks matched the selection.
422	Missing or invalid selection.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/bulk-exit-sequences" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"task_ids":["67c4b113b4dd8f2d4999f0f1"],"lead_status":"nurture"}'

Request body

json

{
  "task_ids": [
    "67c4b113b4dd8f2d4999f0f1"
  ],
  "lead_status": "nurture"
}

Response example

json

{
  "success": true,
  "matched_count": 1,
  "matched_sequence_tasks": 1,
  "matched_enrollments": 1,
  "matched_tasks": 1,
  "updated_enrollments": 1,
  "updated_tasks": 1,
  "updated_leads": 1,
  "warnings": [],
  "operations": [
    {
      "job_id": "sequence-exit-example",
      "operation_run_id": "oprun_sequence_exit_example"
    }
  ],
  "message": "Exited sequences for 1 selected sequence tasks"
}