---
title: "Update sequence settings and/or schedule"
method: PATCH
path: "/v1/sequences/{sequenceId}/settings"
tags: ["sequences"]
---

# Update sequence settings and/or schedule

`PATCH /v1/sequences/{sequenceId}/settings`

Send a partial update — only the codes in <code>settings[]</code> are changed, the rest are preserved.

<strong>Unsubscribe link (code 1)</strong><br/>The value must contain the <code>{{link}}</code> placeholder (the server swaps in the recipient-specific unsubscribe URL when the email is sent). A non-empty value without <code>{{link}}</code> is rejected.

<strong>Accepted preset snippets</strong> (use these verbatim, or provide any custom HTML that includes <code>{{link}}</code>):
<ol><li><code>If you'd prefer not to receive email from me, &lt;a href="{{link}}" target="_blank"&gt;Unsubscribe here&lt;/a&gt;.</code></li><li><code>If you don't want to receive such emails in future, &lt;a href="{{link}}" target="_blank"&gt;Unsubscribe here&lt;/a&gt;.</code></li><li><code>Not up for all these emails? No Sweat! you can, &lt;a href="{{link}}" target="_blank"&gt;Unsubscribe here&lt;/a&gt;.</code></li></ol>Pass an empty string (<code>""</code>) to disable the unsubscribe link entirely.

<strong>Mutually exclusive with unsubscribe-text (code 2).</strong> Setting one to a non-empty value automatically clears the other.

## Path parameters

- `sequenceId` string, required

## Request body

- UpdateSequenceSettingsDto
  - `settings` SequenceSettingItemDto[] — Array of settings to update. All codes are forwarded.
    - `code` number, required — Integer setting code (1–13). See OpenAPI.md.
    - `value` string, required — Value to write for the setting (always a string). - Toggle codes: `"0"` / `"1"`. - JSON-array codes (`bcc`=7, `cc`=8): JSON-encoded strings, e.g. `"[]"` or `"[\"a@b.com\"]"`. - `unsubscribe-link` (code 1): either `""` (disabled) or an HTML snippet that **must include the `{{link}}` placeholder** — the server replaces `{{link}}` with the recipient-specific unsubscribe URL at send time. Non-empty values without `{{link}}` are rejected. Three preset snippets are accepted verbatim (see OpenAPI.md). - `unsubscribe-text` (code 2): any plain-text string appended to the email footer.
  - `scheduleId` string — Hashed ID of the schedule to assign to this sequence.

## Response `200`

Sequence settings updated

## Other responses

- `400` — 1001: Invalid token<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)