Reassign tasks in bulk
Hands up to 500 open tasks to another team member, one at a time, without changing who owns each enrollment.
Each task follows the rules of POST /v2/sequencer/tasks/{id}/reassign.
Each prospect stays in its sequence under the same owner. A call task leaves the old assignee’s dial list and, while pending, is queued for the new one’s. A task that cannot be reassigned (already resolved, not on the team, or one user_id may not reassign) is listed in failed with the reason, and ok counts the rest.
Acts as user_id. Safe to replay: a task already held by assignee_id is left as it is. Counts against the Sequencer writes rate limit.
Handling the response
Good to know
- Only the tasks move. Each prospect stays in its sequence under the same owner, and the next step’s task goes to that owner. To move prospects for good, reassign their enrollments.
user_idneeds permission for each task: its assignee, the sequence’s owner, a team admin or, for a one-off task, whoever created it. Tasks it may not reassign are listed infailed.- Call tasks leave the old rep’s dial list and are queued for the new rep’s.
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.
500The team member to hand the tasks to. A non-member fails every task, each listed in failed.
Recorded on each reassignment timeline event.
500