Update workflow

Writes the editable draft of a workflow. Send only the keys you want to change; nodes and edges always travel together. When the workflow is published and has no draft yet, a new draft version is created next to the published version and the published version keeps running until you call Publish workflow again. An empty body returns error 139.

Base URL:

PATCH: https://api.smsgatewayapi.com/v1/flows/{flow_id}

Example:

PATCH: https://api.smsgatewayapi.com/v1/flows/flw_5d41402abc4b2a76b9719d911017c592

Parameter	Input	Description
client_id	API client ID	Developer › API & Webhooks › API credentials	Required
client_secret	API client secret	A `cs_` credential, shown once when you create it under Developer › API & Webhooks › API credentials	Required
flow_id	workflow ID	The public ID (flw_...) of the workflow as returned by List workflows; the numeric ID is accepted too	Required
name	name of the workflow	1 to 255 characters	Optional
nodes	list of node objects	1 to 200 nodes; replaces the whole definition together with edges	Optional
edges	list of edge objects	0 to 400 edges; always sent together with nodes	Optional
viewport	{ x, y, zoom }	Position and zoom of the builder canvas	Optional
meta	object	Free-form data that is stored with the version	Optional

<?php
	//PHP - cURL
	$ch = curl_init();
	$url = "https://api.smsgatewayapi.com/v1/flows/{flow_id}";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'name' => "STOP = opt-out (renamed)" //New name (optional); nodes and edges can be sent too, always together
	];

	curl_setopt($ch, CURLOPT_URL, "$url");
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_VERBOSE, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, [
		"X-Client-Id: $client_id",
		"X-Client-Secret: $client_secret",
		"Content-Type: application/json",
	]);
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
	$response = curl_exec($ch);
?>

//NodeJs - HTTP request			
const https = require("https");
const client_id = "XXX"; // Your API client ID (required)
const client_secret = "YYY"; // Your API client secret (required)
const data = JSON.stringify({
	name: 'STOP = opt-out (renamed)', //New name (optional); nodes and edges can be sent too, always together


});
const options = {
    hostname: "api.smsgatewayapi.com",
    port: 443,
    path: "/v1/flows/{flow_id}",
    method: "PATCH",
    headers: {
        "X-Client-Id": client_id,
        "X-Client-Secret": client_secret,
		"Content-Type": "application/json",
		"Content-Length": data.length,
    },
};
const req = https.request(options, (res) => {
    console.log(`statusCode: ${res.statusCode}`);
    res.on("data", (d) => {
        process.stdout.write(d);
    });
});
req.write(data);
req.end();

//Ruby - Net::HTTP			
require "uri"
require "net/http"

url = URI("https://api.smsgatewayapi.com/v1/flows/{flow_id}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["X-Client-Id"] = "XXX" // Your API key
request["X-Client-Secret"] = "YYY" // Your API secret
request["Content-Type"] = "application/json"
form_data = [
	['name', "STOP = opt-out (renamed)"] //New name (optional); nodes and edges can be sent too, always together


]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body

//Python - Requests			
import requests
url = "https://api.smsgatewayapi.com/v1/flows/{flow_id}"
payload={
	'name' : 'STOP = opt-out (renamed)' #New name (optional); nodes and edges can be sent too, always together
}
headers = {
	'X-Client-Id': 'XXX', #Your API key
	'X-Client-Secret': 'YYY', #Your API secret
	'Content-Type': 'application/json'
}
response = requests.request(
	"PATCH",
	url,
	headers=headers,
	json=payload
)
print(response.text)

//PowerShell - RestMethod
$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("X-Client-Id", "XXX") // Your API key
$headers.Add("X-Client-Secret", "YYY") // Your API secret

$body = '{
	"name": "STOP = opt-out (renamed)" //New name (optional); nodes and edges can be sent too, always together


}'

$response = Invoke-RestMethod 'https://api.smsgatewayapi.com/v1/flows/{flow_id}' -Method 'PATCH' -Headers $headers -Body $body -ContentType “application/json; charset=utf-8”
$response | ConvertTo-Json

//Shell - wget
wget --no-check-certificate --quiet \
  --method PATCH \
  --timeout=0 \
  --header 'X-Client-Id: XXX' \ // Your API key
  --header 'X-Client-Secret: YYY' \ // Your API secret
  --header 'Content-Type: application/json' \
  --body-data '{
	"name" : "STOP = opt-out (renamed)" //New name (optional); nodes and edges can be sent too, always together


}' \
   'https://api.smsgatewayapi.com/v1/flows/{flow_id}'

Example request:

{
	"name": "STOP = opt-out (renamed)"
}

Example success response:

{
	"id": "flw_5d41402abc4b2a76b9719d911017c592",
	"uuid": "c0a8012e-4f5b-4d6c-8e9f-1a2b3c4d5e6f",
	"name": "STOP = opt-out (renamed)",
	"status": "active",
	"trigger_type": "inbound_message",
	"trigger_config": {
		"triggerType": "inbound_message",
		"inboxId": 0
	},
	"published_version_number": 1,
	"draft_version_number": 2,
	"has_draft_changes": true,
	"published_at": "2026-09-01T09:00:00+02:00",
	"updated_at": "2026-09-08T11:02:41+02:00",
	"nodes": [ ... ],
	"edges": [ ... ],
	"viewport": null,
	"meta": null,
	"version_number": 2,
	"version_status": "draft"
}

The workflow was published (version 1 stays active); the change went into a new draft, version 2.

Example error response:

{
	"error": 139,
	"errorMsg": "Parameters nodes and edges must be sent together"
}

API

Guides

Messages

Voice

WhatsApp Business

Groups

Contacts

Outbox

Account

Sender IDs

Teammate/Subaccount

Conversations

Workflows

Message Templates

Birthday Message

Opt-out

Other

Webhooks (v2)

Update workflow

SMS API

REGISTER NOW