Reorder steps

curl --request PUT \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_id": "507f1f77bcf86cd799439011",
  "step_ids": [
    "6650c3a1b2c3d4e5f6a7b802",
    "6650c3a1b2c3d4e5f6a7b801",
    "6650c3a1b2c3d4e5f6a7b803"
  ]
}
'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder"

payload = {
    "user_id": "507f1f77bcf86cd799439011",
    "step_ids": ["6650c3a1b2c3d4e5f6a7b802", "6650c3a1b2c3d4e5f6a7b801", "6650c3a1b2c3d4e5f6a7b803"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '507f1f77bcf86cd799439011',
    step_ids: [
      '6650c3a1b2c3d4e5f6a7b802',
      '6650c3a1b2c3d4e5f6a7b801',
      '6650c3a1b2c3d4e5f6a7b803'
    ]
  })
};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '507f1f77bcf86cd799439011',
    'step_ids' => [
        '6650c3a1b2c3d4e5f6a7b802',
        '6650c3a1b2c3d4e5f6a7b801',
        '6650c3a1b2c3d4e5f6a7b803'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder"

	payload := strings.NewReader("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{}

{
  "message": "step_ids must list every step in this sequence exactly once; missing: 6650c3a1b2c3d4e5f6a7b803",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Only the sequence owner or a team admin can change this sequence",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Cannot reorder steps while 12 prospect(s) are partway through this sequence. Disable the sequence, make your changes, then enable it again.",
  "error": "Conflict",
  "statusCode": 409,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Steps

Reorder steps

Sets the order of the cadence. Send every step id of the sequence exactly once, in the new order; the first becomes step 1. The response is the steps in their new order, as a JSON array in the same shape as GET /v2/sequencer/sequences/{sequence_id}/steps.

Refused with 409 while any enrollment in the sequence is active or paused: renumbering would move the step each person is on, so someone could receive a step twice or miss one. Disabling the sequence does not lift this, because disabling pauses enrollments, even though the 409 message suggests it. pending enrollments do not block. To restructure a sequence people are moving through, duplicate it, change the copy, and move people over with POST /v2/sequencer/enrollments/bulk/move (they start the copy from its first step), or wait until everyone in it has finished.

Safe to retry: the same body produces the same order. user_id must be the author, the team owner or a team admin. Counts toward the Sequencer writes rate limit.

PUT

sequencer

sequences

{sequence_id}

steps

reorder

Reorder steps

curl --request PUT \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_id": "507f1f77bcf86cd799439011",
  "step_ids": [
    "6650c3a1b2c3d4e5f6a7b802",
    "6650c3a1b2c3d4e5f6a7b801",
    "6650c3a1b2c3d4e5f6a7b803"
  ]
}
'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder"

payload = {
    "user_id": "507f1f77bcf86cd799439011",
    "step_ids": ["6650c3a1b2c3d4e5f6a7b802", "6650c3a1b2c3d4e5f6a7b801", "6650c3a1b2c3d4e5f6a7b803"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '507f1f77bcf86cd799439011',
    step_ids: [
      '6650c3a1b2c3d4e5f6a7b802',
      '6650c3a1b2c3d4e5f6a7b801',
      '6650c3a1b2c3d4e5f6a7b803'
    ]
  })
};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '507f1f77bcf86cd799439011',
    'step_ids' => [
        '6650c3a1b2c3d4e5f6a7b802',
        '6650c3a1b2c3d4e5f6a7b801',
        '6650c3a1b2c3d4e5f6a7b803'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder"

	payload := strings.NewReader("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{sequence_id}/steps/reorder")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"507f1f77bcf86cd799439011\",\n  \"step_ids\": [\n    \"6650c3a1b2c3d4e5f6a7b802\",\n    \"6650c3a1b2c3d4e5f6a7b801\",\n    \"6650c3a1b2c3d4e5f6a7b803\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{}

{
  "message": "step_ids must list every step in this sequence exactly once; missing: 6650c3a1b2c3d4e5f6a7b803",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Only the sequence owner or a team admin can change this sequence",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Cannot reorder steps while 12 prospect(s) are partway through this sequence. Disable the sequence, make your changes, then enable it again.",
  "error": "Conflict",
  "statusCode": 409,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Sets the order of the cadence. Send every step id of the sequence exactly once, in the order you want; the first id becomes step 1.

Example

curl -X PUT https://client-api.salesfinity.co/v2/sequencer/sequences/6650c1f2a9b8c7d6e5f40123/steps/reorder \
  -H 'x-api-key: YOUR_API_KEY' -H 'content-type: application/json' \
  -d '{
    "user_id": "507f1f77bcf86cd799439011",
    "step_ids": ["6650c3a1b2c3d4e5f6a7b802", "6650c3a1b2c3d4e5f6a7b801", "6650c3a1b2c3d4e5f6a7b803"]
  }'

The response is the steps in their new order: a JSON array in the same shape as List steps, not an object.

Reordering is refused with 409 while any enrollment in the sequence is active or paused: renumbering would move the step each person is on, so someone could get a step twice or miss one. The 409 message says to disable the sequence first, but that does not work, because disabling pauses enrollments and paused enrollments still block. pending enrollments do not block.

Changing the order of a sequence people are in

Duplicate the sequence.
Reorder, add or delete steps on the copy.
Enable the copy.
Move people over with Move enrollments to another sequence. They start the copy from its first step.

Or wait until everyone in the original has finished.

When the body is refused

A 400 when step_ids repeats an id, leaves out a step of the sequence, or includes an id that is not in it. message names the ids. Also a 400 when the new order would make an auto_email step start a thread while it has a template with no subject, for example moving a step that replies in a thread in front of the first email. Sending the same body twice gives the same order, so a retry is safe. user_id must be the sequence’s author, the team owner or a team admin.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

sequence_id

string

required

24-character sequence id.

Body

application/json

user_id

string

required

The team member making the change. Must be the sequence's author, the team owner or a team admin, and have an active plan or seat. A 24-character hexadecimal ID.

Example:

"507f1f77bcf86cd799439011"

step_ids

string[]

required

Every step id of the sequence, each exactly once, in the new order. The first becomes step 1. Each is a 24-character hexadecimal ID.

Maximum array length: 50

Response

The steps in their new order. Production returns a JSON array of steps here, not an object; see the operation description.

The outcome of an action. Shape varies by endpoint — for example enable returns the sequence and how many enrollments it activated, and a bulk verb returns how many rows it moved.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Reorder steps

Example

Changing the order of a sequence people are in

When the body is refused

Authorizations

Path Parameters

Body

Response

​Example

​Changing the order of a sequence people are in

​When the body is refused

Authorizations

Path Parameters

Body

Response

Example

Changing the order of a sequence people are in

When the body is refused