Sequences

Update a Sequence Step

Changed on

Updates the copy on a single step of a sequence. step_id is the id of the entry in the sequence's tasks list (from get_sequence). Supports message on email, InMail, LinkedIn message, LinkedIn connection-note, and gifting-email steps, and subject on email, InMail, and gifting-email steps. Any supported step that exists and has not been completed can be edited. Only the fields you provide are updated, and omitted fields are left unchanged. Returns the refreshed step. Template variables must be namespaced. Supported tokens are {{recipient.first_name}}, {{recipient.last_name}}, {{recipient.company}}, {{recipient.email}}, {{recipient.title}}, {{recipient.location}}, {{recipient.notes}}, {{sender.first_name}}, {{sender.last_name}}, {{sender.company}}, {{sender.title}}, {{sender.email}}, {{account.industries}}, {{account.notes}}, and {{account.description}}. Custom fields are referenced as {{recipient.<custom-field-id>}} or {{account.<custom-field-id>}}.

patch/v1/sequences/{sequence_id}/steps/{step_id}

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/sequences/{sequence_id}/steps/{step_id}
  • Auth
    none declared

Path parameters

sequence_idstring uuid required
step_idstring uuid required

Request body

messagestring nullable

New message body for the step. Supported on email, InMail, LinkedIn message, LinkedIn connection-note, and gifting-email steps. Provide final per-contact copy as plain text — unresolved placeholders like {{first_name}} and HTML are rejected. LinkedIn connection notes can be up to 300 characters, but a free LinkedIn account can only send notes up to 200, so a longer note fails to send from a free account.

subjectstring nullable

New subject line for the step. Only supported on subject-bearing channels (email, InMail, gifting email). On an InMail step, an empty string clears the subject; email and gifting-email steps require a non-empty subject.

Response

Successful Response

Example response

{
  "data": {
    "id": "tsk_abc123",
    "sequence_id": "seq_def456",
    "order": 1,
    "name": "Send intro email",
    "scheduled_at": "2026-05-15T09:00:00Z",
    "completed_at": "2026-05-15T10:00:00Z",
    "hold_until": "2026-05-15T16:00:00Z"
  }
}

Changes