Update sequence - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Send the full action catalog and explicit flowGraph for every authored design, including straight-line sequences. Exactly one entryNodeIds node and the edges determine execution; steps order does not. Steps-only graphless writes are rejected. See Create sequence for graph guidance.

The response retains the {success, sequence} envelope. A committed configuration change increments sequence.config_revision. When removed steps, schedule changes, or provider email content require follow-up work, the save durably admits that work together with the configuration under optimistic concurrency; it does not wait for every task, outbox, enrollment, or provider effect to finish.

Read sequence.config_reconciliation.operation_run_id when present and follow canonical operation-run progress. Its job_id is the separate native job identity; status=pending is an admission state. Re-read and reconcile after 409. The example shows an abridged saved sequence with required reconciliation admitted.

Path parameters

sequence_idrequired
string
Sequence ID.

Name	Type	Description
sequence_idrequired	string	Sequence ID.

Query parameters

expectedUpdatedAt · optional
string (ISO datetime)
Saved updatedAt value used as an optimistic concurrency guard. The backend also compares the loaded configuration revision; concurrent changes return 409.
actorUserId · optional
string
Optional actor override; must resolve to an active user in the same org.

Name	Type	Description
expectedUpdatedAt	string (ISO datetime)	Saved updatedAt value used as an optimistic concurrency guard. The backend also compares the loaded configuration revision; concurrent changes return 409.
actorUserId	string	Optional actor override; must resolve to an active user in the same org.

Body parameters

namerequired
string
Sequence name.
sourceTableId · optional
string
Optional in the model; required for developer API key requests.
sourceTableName · optional
string
Optional source table display name.
description · optional
string
Optional sequence description.
steps · optional
array<object>
Action content catalog referenced by flowGraph; array order does not determine execution. Defaults to []; developer API key requests must include at least one step.
exitRulesrequired
object
Exit behavior configuration.
schedulerequired
object
Timezone + working window configuration.
flowGraph · optional
object
Required when actions exist, including straight-line sequences. Declare version=1, exactly one entryNodeIds node, action nodes, and explicit routing edges.
enrollmentRules · optional
object
Optional enrollment policy.
requiredVariables · optional
array<string>
Optional required template variables.
emailDelivery · optional
object
Delivery mode and provider settings; managed delivery is rejected.
inboxAccess · optional
object
Optional inbox access configuration.
senderAccountIds · optional
object
Optional channel-keyed sender account IDs.
senderBindings · optional
object
Optional channel-keyed sender binding definitions.
allowHqFallback · optional
boolean
Company-phone fallback for call steps when a lead phone is absent.
aiAutomationTrusted · optional
boolean
Trust flag for permitted AI-drafted automated steps.
aiDraftSettings · optional
object
Optional sequence AI-draft settings.
variableMap · optional
object
Optional variable-to-source-field mapping.
voiceStyle · optional
object
Optional voice style settings.
defaultAppendSignature · optional
boolean
Default signature behavior for email steps. Defaults to true when omitted.
steps[].appendSignature · optional
boolean
Step-level override for signature append behavior.

Name	Type	Description
namerequired	string	Sequence name.
sourceTableId	string	Optional in the model; required for developer API key requests.
sourceTableName	string	Optional source table display name.
description	string	Optional sequence description.
steps	array<object>	Action content catalog referenced by flowGraph; array order does not determine execution. Defaults to []; developer API key requests must include at least one step.
exitRulesrequired	object	Exit behavior configuration.
schedulerequired	object	Timezone + working window configuration.
flowGraph	object	Required when actions exist, including straight-line sequences. Declare version=1, exactly one entryNodeIds node, action nodes, and explicit routing edges.
enrollmentRules	object	Optional enrollment policy.
requiredVariables	array<string>	Optional required template variables.
emailDelivery	object	Delivery mode and provider settings; managed delivery is rejected.
inboxAccess	object	Optional inbox access configuration.
senderAccountIds	object	Optional channel-keyed sender account IDs.
senderBindings	object	Optional channel-keyed sender binding definitions.
allowHqFallback	boolean	Company-phone fallback for call steps when a lead phone is absent.
aiAutomationTrusted	boolean	Trust flag for permitted AI-drafted automated steps.
aiDraftSettings	object	Optional sequence AI-draft settings.
variableMap	object	Optional variable-to-source-field mapping.
voiceStyle	object	Optional voice style settings.
defaultAppendSignature	boolean	Default signature behavior for email steps. Defaults to true when omitted.
steps[].appendSignature	boolean	Step-level override for signature append behavior.

Errors

Status	Meaning
400	Invalid payload or actor.
401	Invalid API key or missing auth.
403	Missing sequences:write scope.
404	Sequence not found.
409	Optimistic concurrency conflict or configuration cannot be applied.

Example

bash

curl -X PUT "https://app.autotouch.ai/api/sequences/67c4a4f7b4dd8f2d4999f014?actorUserId=<USER_ID>" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d @sequence-update.json

Request body

json

{
    "name": "Outbound v1 - revised",
    "sourceTableId": "tbl_123",
    "exitRules": {
      "stopOnReply": true,
      "stopOnBounce": true,
      "stopOnManualOptOut": true
    },
    "schedule": {
      "timezone": "America/New_York",
      "workingDays": [1,2,3,4,5],
      "dailyWindowStart": "09:00",
      "dailyWindowEnd": "17:00",
      "skipHolidays": false
    },
    "defaultAppendSignature": false,
    "steps": [
      {
        "id": "s1",
        "kind": "EMAIL",
        "emailSendMode": "AUTOMATED",
        "emailIsReply": false,
        "appendSignature": false,
        "subjectTemplate": "Updated subject",
        "bodyTemplate": "Updated body"
      }
    ],
    "flowGraph": {
      "version": 1,
      "entryNodeIds": ["step:s1"],
      "nodes": [{ "id": "step:s1", "kind": "action", "sourceStepId": "s1", "position": { "x": 0, "y": 0 } }],
      "edges": []
    }
  }

Response example

json

{
    "success": true,
    "sequence": {
      "id": "67c4a4f7b4dd8f2d4999f014",
      "name": "Outbound v1 - revised",
      "status": "DRAFT",
      "config_revision": 2,
      "config_reconciliation": {
        "status": "pending",
        "revision": 2,
        "job_id": "sequence-config-example",
        "operation_run_id": "oprun_sequence_config_example"
      },
      "steps": [
        { "id": "s1", "kind": "EMAIL", "emailSendMode": "AUTOMATED", "emailIsReply": false, "appendSignature": false, "subjectTemplate": "Updated subject", "bodyTemplate": "Updated body" }
      ],
      "sourceTableId": "tbl_123",
      "createdAt": "2026-09-01T12:00:00Z",
      "updatedAt": "2026-09-27T12:00:00Z"
    }
  }