Skip tasks in bulk
Skips up to 500 tasks, one at a time, with the same rules as POST /v2/sequencer/tasks/{id}/skip.
Each skipped sequence task moves its enrollment to the next step, and a skipped call task from a sequence leaves the dial list. A task that cannot be skipped (already resolved, held, its enrollment no longer active, or not on the team) does not stop the batch: it is listed in failed with the reason, and ok counts the rest.
There is no bulk complete, deliberately. Completing a manual_email task sends a real email, so a bulk complete would send drafts nobody reviewed. Complete tasks one at a time with POST /v2/sequencer/tasks/{id}/complete.
Acts as user_id. Send an Idempotency-Key: replaying a batch without one reports every already-skipped task as failed. Counts against the Sequencer writes rate limit.
Handling the response
failed lists what did not happen, and why.
Good to know
- Skipping a sequence task moves its enrollment to the next step. To stop contacting the prospect, finish the enrollment instead.
heldtasks, and tasks whose enrollment is no longer active, are refused and listed infailed.- Replaying the request without an
Idempotency-Keylists the already-skipped tasks infailed.
Authorizations
Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.
Headers
Makes this write safe to retry. Send a unique value, such as a UUID, and send the same value again when you retry the same request. A retry with the same key and the same request (method, path including the query string, and JSON body) returns the original successful response without acting twice. The same key with a different body or path returns 409, and so does a retry while the first request is still running; that one is safe to repeat after a moment. A request that fails frees its key, so a retry runs the write again: after a 5xx on a create, confirm with a GET before retrying. Keys are kept for 24 hours and are scoped to your team.
Body
The team member this call acts as. Must be an active member of the team the API key belongs to.
"507f1f77bcf86cd799439011"
Task ids, 1 to 500. Each is processed on its own, and a failure is returned in failed.
500Why the tasks were skipped. Recorded on each timeline.
200