POST

api

sequences

{sequenceId}

enrollments

realign-sending-window

Realign Sequence Enrollments

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodeIds": [
    {}
  ],
  "subscriberIds": [
    {}
  ],
  "cursor": "<string>",
  "dryRun": true
}
'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window"

payload = {
    "nodeIds": [{}],
    "subscriberIds": [{}],
    "cursor": "<string>",
    "dryRun": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({nodeIds: [{}], subscriberIds: [{}], cursor: '<string>', dryRun: true})
};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window', 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://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'nodeIds' => [
        [
                
        ]
    ],
    'subscriberIds' => [
        [
                
        ]
    ],
    'cursor' => '<string>',
    'dryRun' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window"

	payload := strings.NewReader("{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.post("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}"

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

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": false,
  "status": "queued",
  "jobId": "realign-sequence-enrollments-seq_abc123-...",
  "message": "Enrollment realignment queued. Poll the job status endpoint for the result before continuing with nextCursor."
}

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": true,
  "sendingWindow": {
    "enabled": true,
    "timezone": "America/Los_Angeles",
    "startTime": "08:00",
    "endTime": "12:00",
    "days": ["sunday"]
  },
  "scannedCount": 330,
  "realignedCount": 330,
  "unchangedCount": 0,
  "unchangedReasons": {},
  "requeueFailedCount": 0,
  "changes": [
    {
      "enrollmentId": "tok_abc123",
      "subscriberId": "sub_abc123",
      "subscriberEmail": "customer@example.com",
      "currentNodeId": "node_week_14",
      "waitUntil": "2026-08-16T18:13:00.000Z",
      "newWaitUntil": "2026-08-16T15:00:00.000Z",
      "movedEarlierMinutes": 193
    }
  ],
  "hasMore": false,
  "maxRealignmentsPerRequest": 1000,
  "message": "330 waiting enrollments would move earlier. Re-run with dryRun false to apply."
}

{
  "error": "A maximum of 500 subscriberIds can be realigned per request"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing the sequences:enroll scope"
}

{
  "error": "Sequence not found"
}

Realign Sequence Enrollments

Changing a live sequence’s sending window deliberately leaves contacts who are already waiting on an email-bound delay step alone: they keep the wake-up time their delay produced. That means a widened window never reaches them, and a narrowed window pushes them to the next allowed day - a full extra cycle on a weekly sequence. This endpoint pulls those waits forward instead. It never cancels or re-enrolls anyone.

Guarantees

A wait only ever moves earlier, never later.
A wait never moves to a different local day in the window’s timezone, so nobody changes weekly cycle.
A wait never moves earlier than now, so nothing is sent retroactively.
Per-step “wait until weekday” gates are respected: a contact is never moved earlier than the step’s own window opening.
Sequence windows never advance SMS, webhooks, branches, or other non-email actions.
Running it twice is a no-op. Waits already sitting at their opening report already_at_window_start.

Request

string

required

Sequence ID.

array

Step IDs to limit realignment to. Use nodeIds from Get Sequence or currentNodeId values from List Enrollments. Defaults to every step when omitted; when provided, it must contain at least one non-empty ID.

array

Up to 500 subscriber IDs to limit realignment to. Defaults to every waiting contact when omitted; when provided, it must contain at least one non-empty ID.

string

Opaque continuation cursor. When a response has hasMore: true, pass its nextCursor here to continue after the enrollments already scanned.

boolean

When true (the default), returns the new wait times without writing them. Set it to false to queue a background apply job.

curl -X POST "https://api.sequenzy.com/api/v1/sequences/seq_abc123/enrollments/realign-sending-window" \
  -H "Authorization: Bearer seq_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "dryRun": false
  }'

Why an enrollment did not move

unchangedReasons counts each reason:

Reason	Meaning
`already_at_window_start`	The wait is already at or before that day’s opening
`already_due`	The wait has passed and the enrollment is about to resume
`day_not_allowed`	The wait lands on a day the window does not cover, so moving it would change the send day
`no_shared_opening`	The sequence window and the step’s weekday gate never overlap before the wait
`no_window`	Neither the sequence nor the contact’s current step defines a window
`not_email_bound`	The delay’s next action is not an email, so the sequence window does not govern it
`send_retry`	The email is waiting on a provider retry backoff, which realignment never shortens
`raced`	A worker advanced the enrollment between the scan and the write

Paging through a large sequence

Each job moves at most 1,000 enrollments and inspects at most 20,000. An applied request returns HTTP 202 with a jobId; poll GET /api/v1/sequences/{sequenceId}/enrollments/realign-sending-window/jobs/{jobId} until it completes. When the completed result has hasMore: true, pass its nextCursor back as cursor to queue the next bounded job.

sequenzy sequences realign-enrollments seq_abc123 --apply
sequenzy sequences realign-enrollments seq_abc123 --job-id <printed-job-id>
sequenzy sequences realign-enrollments seq_abc123 --apply --cursor eyJzY2hlZHVsZWRGb3IiOiIuLi4ifQ

Responses

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": false,
  "status": "queued",
  "jobId": "realign-sequence-enrollments-seq_abc123-...",
  "message": "Enrollment realignment queued. Poll the job status endpoint for the result before continuing with nextCursor."
}

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": true,
  "sendingWindow": {
    "enabled": true,
    "timezone": "America/Los_Angeles",
    "startTime": "08:00",
    "endTime": "12:00",
    "days": ["sunday"]
  },
  "scannedCount": 330,
  "realignedCount": 330,
  "unchangedCount": 0,
  "unchangedReasons": {},
  "requeueFailedCount": 0,
  "changes": [
    {
      "enrollmentId": "tok_abc123",
      "subscriberId": "sub_abc123",
      "subscriberEmail": "customer@example.com",
      "currentNodeId": "node_week_14",
      "waitUntil": "2026-08-16T18:13:00.000Z",
      "newWaitUntil": "2026-08-16T15:00:00.000Z",
      "movedEarlierMinutes": 193
    }
  ],
  "hasMore": false,
  "maxRealignmentsPerRequest": 1000,
  "message": "330 waiting enrollments would move earlier. Re-run with dryRun false to apply."
}

{
  "error": "A maximum of 500 subscriberIds can be realigned per request"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing the sequences:enroll scope"
}

{
  "error": "Sequence not found"
}

Realign Sequence Enrollments

curl --request POST \
  --url https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodeIds": [
    {}
  ],
  "subscriberIds": [
    {}
  ],
  "cursor": "<string>",
  "dryRun": true
}
'

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window"

payload = {
    "nodeIds": [{}],
    "subscriberIds": [{}],
    "cursor": "<string>",
    "dryRun": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({nodeIds: [{}], subscriberIds: [{}], cursor: '<string>', dryRun: true})
};

fetch('https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window', 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://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'nodeIds' => [
        [
                
        ]
    ],
    'subscriberIds' => [
        [
                
        ]
    ],
    'cursor' => '<string>',
    'dryRun' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window"

	payload := strings.NewReader("{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.post("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments/realign-sending-window")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nodeIds\": [\n    {}\n  ],\n  \"subscriberIds\": [\n    {}\n  ],\n  \"cursor\": \"<string>\",\n  \"dryRun\": true\n}"

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

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": false,
  "status": "queued",
  "jobId": "realign-sequence-enrollments-seq_abc123-...",
  "message": "Enrollment realignment queued. Poll the job status endpoint for the result before continuing with nextCursor."
}

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "52-Week Medicine Wheel",
  "dryRun": true,
  "sendingWindow": {
    "enabled": true,
    "timezone": "America/Los_Angeles",
    "startTime": "08:00",
    "endTime": "12:00",
    "days": ["sunday"]
  },
  "scannedCount": 330,
  "realignedCount": 330,
  "unchangedCount": 0,
  "unchangedReasons": {},
  "requeueFailedCount": 0,
  "changes": [
    {
      "enrollmentId": "tok_abc123",
      "subscriberId": "sub_abc123",
      "subscriberEmail": "customer@example.com",
      "currentNodeId": "node_week_14",
      "waitUntil": "2026-08-16T18:13:00.000Z",
      "newWaitUntil": "2026-08-16T15:00:00.000Z",
      "movedEarlierMinutes": 193
    }
  ],
  "hasMore": false,
  "maxRealignmentsPerRequest": 1000,
  "message": "330 waiting enrollments would move earlier. Re-run with dryRun false to apply."
}

{
  "error": "A maximum of 500 subscriberIds can be realigned per request"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing the sequences:enroll scope"
}

{
  "error": "Sequence not found"
}

​Realign Sequence Enrollments

​Guarantees

​Request

​Why an enrollment did not move

​Paging through a large sequence

​Responses

Realign Sequence Enrollments

Guarantees

Request

Why an enrollment did not move

Paging through a large sequence

Responses