Update a sequence step

curl --request PUT \
  --url https://api.reply.io/v3/sequences/{id}/steps/{step_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "delayInMinutes": 1,
  "variants": [
    {
      "id": 123,
      "subject": "<string>",
      "message": "<string>",
      "attachmentIds": [
        123
      ]
    }
  ],
  "parentId": 123,
  "ifConditionPositive": true
}
'

import requests

url = "https://api.reply.io/v3/sequences/{id}/steps/{step_id}"

payload = {
    "type": "email",
    "delayInMinutes": 1,
    "variants": [
        {
            "id": 123,
            "subject": "<string>",
            "message": "<string>",
            "attachmentIds": [123]
        }
    ],
    "parentId": 123,
    "ifConditionPositive": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'email',
    delayInMinutes: 1,
    variants: [{id: 123, subject: '<string>', message: '<string>', attachmentIds: [123]}],
    parentId: 123,
    ifConditionPositive: true
  })
};

fetch('https://api.reply.io/v3/sequences/{id}/steps/{step_id}', 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.reply.io/v3/sequences/{id}/steps/{step_id}",
  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([
    'type' => 'email',
    'delayInMinutes' => 1,
    'variants' => [
        [
                'id' => 123,
                'subject' => '<string>',
                'message' => '<string>',
                'attachmentIds' => [
                                123
                ]
        ]
    ],
    'parentId' => 123,
    'ifConditionPositive' => 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.reply.io/v3/sequences/{id}/steps/{step_id}"

	payload := strings.NewReader("{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.reply.io/v3/sequences/{id}/steps/{step_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/steps/{step_id}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}"

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

{
  "type": "email",
  "delayInMinutes": 1,
  "executionMode": "automatic",
  "variants": [
    {
      "id": 123,
      "subject": "<string>",
      "message": "<string>",
      "hasAttachments": true
    }
  ],
  "id": 123,
  "parentId": 123,
  "ifConditionPositive": true
}

Sequence Steps

Update a sequence step

Requires the sequences:write scope (or a broader one that includes it).

Use this endpoint when you need to change what an existing step does — its delayInMinutes, its message content or its per-type settings. Send the whole step, and give each variant you want to change its id; a variant sent without an id is added as a new one, and variants you leave out stay as they are, so use the delete-variant endpoint to remove one. A step’s place in the flow is fixed once it exists, so parentId and ifConditionPositive cannot be changed here. Once any contact has been processed on a step it is locked and its type can no longer be changed, and the call is rejected. Contacts already partway through the sequence stay in it, and their current step and next send time are recalculated against the step you just saved.

PUT

sequences

{id}

steps

{step_id}

Update a sequence step

curl --request PUT \
  --url https://api.reply.io/v3/sequences/{id}/steps/{step_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "delayInMinutes": 1,
  "variants": [
    {
      "id": 123,
      "subject": "<string>",
      "message": "<string>",
      "attachmentIds": [
        123
      ]
    }
  ],
  "parentId": 123,
  "ifConditionPositive": true
}
'

import requests

url = "https://api.reply.io/v3/sequences/{id}/steps/{step_id}"

payload = {
    "type": "email",
    "delayInMinutes": 1,
    "variants": [
        {
            "id": 123,
            "subject": "<string>",
            "message": "<string>",
            "attachmentIds": [123]
        }
    ],
    "parentId": 123,
    "ifConditionPositive": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'email',
    delayInMinutes: 1,
    variants: [{id: 123, subject: '<string>', message: '<string>', attachmentIds: [123]}],
    parentId: 123,
    ifConditionPositive: true
  })
};

fetch('https://api.reply.io/v3/sequences/{id}/steps/{step_id}', 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.reply.io/v3/sequences/{id}/steps/{step_id}",
  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([
    'type' => 'email',
    'delayInMinutes' => 1,
    'variants' => [
        [
                'id' => 123,
                'subject' => '<string>',
                'message' => '<string>',
                'attachmentIds' => [
                                123
                ]
        ]
    ],
    'parentId' => 123,
    'ifConditionPositive' => 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.reply.io/v3/sequences/{id}/steps/{step_id}"

	payload := strings.NewReader("{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.reply.io/v3/sequences/{id}/steps/{step_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/steps/{step_id}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"email\",\n  \"delayInMinutes\": 1,\n  \"variants\": [\n    {\n      \"id\": 123,\n      \"subject\": \"<string>\",\n      \"message\": \"<string>\",\n      \"attachmentIds\": [\n        123\n      ]\n    }\n  ],\n  \"parentId\": 123,\n  \"ifConditionPositive\": true\n}"

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

{
  "type": "email",
  "delayInMinutes": 1,
  "executionMode": "automatic",
  "variants": [
    {
      "id": 123,
      "subject": "<string>",
      "message": "<string>",
      "hasAttachments": true
    }
  ],
  "id": 123,
  "parentId": 123,
  "ifConditionPositive": true
}

Authorizations

Authorization

string

header

required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

integer

required

Sequence Id

step_id

integer

required

Step Id

Body

application/json

Email step with variant configuration for update operations

type

enum<string>

required

Step type discriminator

Available options:

email

delayInMinutes

integer

required

Delay in minutes before executing this step

Required range: x >= 0

executionMode

enum<string>

required

Execution mode for the email step

Available options:

automatic,

manual

variants

Email Variant (Update) · object[]

required

Array of email variants (A/B test versions). Each variant must include its id for update operations.

Show child attributes

parentId

integer | null

ID of the parent step (for branching)

ifConditionPositive

boolean | null

Whether this step is on the positive branch of a condition

Response

Sequence step updated successfully

Email step with variant configuration

type

enum<string>

required

Step type discriminator

Available options:

email

delayInMinutes

integer

required

Delay in minutes before executing this step

Required range: x >= 0

executionMode

enum<string>

required

Execution mode for the email step

Available options:

automatic,

manual

variants

Email Variant · object[]

required

Array of email variants (A/B test versions)

Show child attributes

integer | null

read-only

Unique identifier for the step

parentId

integer | null

ID of the parent step (for branching)

ifConditionPositive

boolean | null

Whether this step is on the positive branch of a condition

Getting started

For AI agents

API Documentation

Schemas

Webhooks

Machine-readable

Update a sequence step

Authorizations

Path Parameters

Body

Response