Update a step
PATCH/v1/flows/:flow_id/steps/:step_id
Updates a step. At least one writable field must be given. Omitting shared_email_id leaves the shared inbox attached; send null to detach it. On an active flow, changing delay_minutes reschedules this step's queued sends, except for candidates on a custom schedule.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Step updated
Missing or invalid bearer token.
The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to edit this flow, or the API key lacks the flows:write scope (err_insufficient_scope).
Flow not found (err_flow_not_found), or the step is not in the flow (err_step_not_found).
Validation failed. Error codes:
err_template_id_required- the channel needs a template and none was givenerr_template_not_found- unknown templateerr_template_channel_mismatch- the template's channel is not the step's channelerr_mode_not_allowed_for_channel-manualwas sent on a LinkedIn channelerr_sender_not_found- unknown or inactivesender_iderr_sender_mailbox_not_connected- the sender has no mailbox connectederr_sender_email_delegation_disabled- the sender does not allow sending on their behalferr_no_access_to_shared_email- unknown shared inbox, or one the sender cannot send fromerr_invalid_channel_for_shared_email- a shared inbox was given on a channel other than emailerr_flow_step_limit_exceeded- the account's steps-per-flow limit is reachederr_flow_archived- the flow is archived and cannot be changederr_flow_completed- the flow is completed and cannot be changederr_on_behalf_of_not_allowed- a personal access token passed another user's IDerr_user_not_found-on_behalf_ofis not an active user in the accounterr_on_behalf_of_forbidden- that user is not allowed to perform this action