Update an action

put

https://api.salesautopilot.com/v2/actions/{actionId}

Partially update an existing action (letter or form). All request body fields are optional — only the fields you supply are changed. Fields omitted from the request retain their current values.

source_list_id — optional source list change:

Pass 0 to revert to automatic (letter: source = the send's target list; form: source = the form's parent list).
Pass a specific list ID to fix the source list.
Omit entirely to keep the current source list setting unchanged.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

actionId

integer

required

ID of the action

Body Params

All fields are optional — only supplied fields are updated. Works for both letter actions and form actions.

action_type

string

enum

Allowed:

name

string

letter_trigger

string

enum

Letter trigger (applicable to letter actions only).

Allowed:

source_list_id

integer

Source list change. Optional.

0: revert to automatic — for letter actions: source = the send's target list; for form actions: source = the form's parent list.
Specific ID: fix the source list to this value.
Omit: keep the current source list setting unchanged.

target_list_id

integer

New target list — the contact will be subscribed to / unsubscribed from / updated in / deleted from this list.

link_urls

array of strings

List of link URLs for on_link_click trigger (letter actions only).
Each URL must exist in the letter. Replaces the current link list when provided.

link_urls

fields

array of objects

fields

external_url

string

external_method

string

enum

Allowed:

external_username

string

external_password

string

notify_on_action

boolean

source_segments

array of integers

New source segment IDs (form actions only). Update semantics:

Omit: keep existing segments unchanged.
[] (empty array): clear all segments (disable filtering).
Non-empty array: replace existing segments.

source_segments

source_segment_conn_type

string

enum

Logical connector between source segments — form actions only (omit to keep existing).

Allowed:

source_segment_negated_ids

array of integers

Subset of source_segments to negate. Must be a subset of the source_segments provided.

source_segment_negated_ids

target_segments

array of integers

New target segment IDs. Update semantics:

Omit: keep existing segments unchanged.
[] (empty array): clear all segments (disable filtering).
Non-empty array: replace existing segments.

target_segments

target_segment_conn_type

string

enum

Logical connector between target segments (omit to keep existing).

Allowed:

target_segment_negated_ids

array of integers

Subset of target_segments to negate. Must be a subset of the target_segments provided.

target_segment_negated_ids

Responses

200Updated action

400Validation error

401Authentication required or invalid token

404Action not found

429Rate limit exceeded

500Internal server error