Update a workflow
curl --request PATCH \
--url https://app.orgo.space/api/v1/workflows/{uuid} \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '
{
"tenant": "/api/v1/tenants/1",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": true,
"priority": 42,
"canvasData": [
"string"
],
"triggers": [
{
"eventType": "string",
"eventFilters": [
"string"
]
}
],
"conditionGroups": [
{
"logicalOperator": "string",
"position": 42,
"conditions": [
"/api/v1/workflow_conditions/1"
]
}
],
"actions": [
{
"type": "MEMBER",
"position": 42,
"config": [
"string"
],
"stopOnFailure": true
}
]
}
'import requests
url = "https://app.orgo.space/api/v1/workflows/{uuid}"
payload = {
"tenant": "/api/v1/tenants/1",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": True,
"priority": 42,
"canvasData": ["string"],
"triggers": [
{
"eventType": "string",
"eventFilters": ["string"]
}
],
"conditionGroups": [
{
"logicalOperator": "string",
"position": 42,
"conditions": ["/api/v1/workflow_conditions/1"]
}
],
"actions": [
{
"type": "MEMBER",
"position": 42,
"config": ["string"],
"stopOnFailure": True
}
]
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({
tenant: '/api/v1/tenants/1',
name: 'Boston Chapter',
description: 'Quarterly chapter meeting open to all members.',
isActive: true,
priority: 42,
canvasData: ['string'],
triggers: [{eventType: 'string', eventFilters: ['string']}],
conditionGroups: [
{
logicalOperator: 'string',
position: 42,
conditions: ['/api/v1/workflow_conditions/1']
}
],
actions: [{type: 'MEMBER', position: 42, config: ['string'], stopOnFailure: true}]
})
};
fetch('https://app.orgo.space/api/v1/workflows/{uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/workflows/{uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'tenant' => '/api/v1/tenants/1',
'name' => 'Boston Chapter',
'description' => 'Quarterly chapter meeting open to all members.',
'isActive' => true,
'priority' => 42,
'canvasData' => [
'string'
],
'triggers' => [
[
'eventType' => 'string',
'eventFilters' => [
'string'
]
]
],
'conditionGroups' => [
[
'logicalOperator' => 'string',
'position' => 42,
'conditions' => [
'/api/v1/workflow_conditions/1'
]
]
],
'actions' => [
[
'type' => 'MEMBER',
'position' => 42,
'config' => [
'string'
],
'stopOnFailure' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/workflows/{uuid}"
payload := strings.NewReader("{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://app.orgo.space/api/v1/workflows/{uuid}")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/workflows/{uuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": true,
"priority": 42,
"canvasData": [
"string"
],
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"createdBy": "/api/v1/users/1",
"triggers": [
{
"id": 42,
"eventType": "string",
"eventFilters": [
"string"
],
"eventLabel": "Primary"
}
],
"conditionGroups": [
{
"id": 42,
"logicalOperator": "string",
"position": 42,
"conditions": [
"/api/v1/workflow_conditions/1"
]
}
],
"actions": [
{
"id": 42,
"type": "MEMBER",
"position": 42,
"config": [
"string"
],
"stopOnFailure": true,
"typeLabel": "Primary",
"typeDescription": "Quarterly chapter meeting open to all members."
}
]
}Workflow
Update a workflow
Updates a workflow including its triggers, condition groups, and actions. Nested entities (triggers, conditions, actions) are cleared and recreated on each update. Supports updating name, description, active status, priority, and canvas layout data. Requires tenant admin permission.
PATCH
/
api
/
v1
/
workflows
/
{uuid}
Update a workflow
curl --request PATCH \
--url https://app.orgo.space/api/v1/workflows/{uuid} \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '
{
"tenant": "/api/v1/tenants/1",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": true,
"priority": 42,
"canvasData": [
"string"
],
"triggers": [
{
"eventType": "string",
"eventFilters": [
"string"
]
}
],
"conditionGroups": [
{
"logicalOperator": "string",
"position": 42,
"conditions": [
"/api/v1/workflow_conditions/1"
]
}
],
"actions": [
{
"type": "MEMBER",
"position": 42,
"config": [
"string"
],
"stopOnFailure": true
}
]
}
'import requests
url = "https://app.orgo.space/api/v1/workflows/{uuid}"
payload = {
"tenant": "/api/v1/tenants/1",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": True,
"priority": 42,
"canvasData": ["string"],
"triggers": [
{
"eventType": "string",
"eventFilters": ["string"]
}
],
"conditionGroups": [
{
"logicalOperator": "string",
"position": 42,
"conditions": ["/api/v1/workflow_conditions/1"]
}
],
"actions": [
{
"type": "MEMBER",
"position": 42,
"config": ["string"],
"stopOnFailure": True
}
]
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({
tenant: '/api/v1/tenants/1',
name: 'Boston Chapter',
description: 'Quarterly chapter meeting open to all members.',
isActive: true,
priority: 42,
canvasData: ['string'],
triggers: [{eventType: 'string', eventFilters: ['string']}],
conditionGroups: [
{
logicalOperator: 'string',
position: 42,
conditions: ['/api/v1/workflow_conditions/1']
}
],
actions: [{type: 'MEMBER', position: 42, config: ['string'], stopOnFailure: true}]
})
};
fetch('https://app.orgo.space/api/v1/workflows/{uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/workflows/{uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'tenant' => '/api/v1/tenants/1',
'name' => 'Boston Chapter',
'description' => 'Quarterly chapter meeting open to all members.',
'isActive' => true,
'priority' => 42,
'canvasData' => [
'string'
],
'triggers' => [
[
'eventType' => 'string',
'eventFilters' => [
'string'
]
]
],
'conditionGroups' => [
[
'logicalOperator' => 'string',
'position' => 42,
'conditions' => [
'/api/v1/workflow_conditions/1'
]
]
],
'actions' => [
[
'type' => 'MEMBER',
'position' => 42,
'config' => [
'string'
],
'stopOnFailure' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/workflows/{uuid}"
payload := strings.NewReader("{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://app.orgo.space/api/v1/workflows/{uuid}")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/workflows/{uuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{\n \"tenant\": \"/api/v1/tenants/1\",\n \"name\": \"Boston Chapter\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"isActive\": true,\n \"priority\": 42,\n \"canvasData\": [\n \"string\"\n ],\n \"triggers\": [\n {\n \"eventType\": \"string\",\n \"eventFilters\": [\n \"string\"\n ]\n }\n ],\n \"conditionGroups\": [\n {\n \"logicalOperator\": \"string\",\n \"position\": 42,\n \"conditions\": [\n \"/api/v1/workflow_conditions/1\"\n ]\n }\n ],\n \"actions\": [\n {\n \"type\": \"MEMBER\",\n \"position\": 42,\n \"config\": [\n \"string\"\n ],\n \"stopOnFailure\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"description": "Quarterly chapter meeting open to all members.",
"isActive": true,
"priority": 42,
"canvasData": [
"string"
],
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"createdBy": "/api/v1/users/1",
"triggers": [
{
"id": 42,
"eventType": "string",
"eventFilters": [
"string"
],
"eventLabel": "Primary"
}
],
"conditionGroups": [
{
"id": 42,
"logicalOperator": "string",
"position": 42,
"conditions": [
"/api/v1/workflow_conditions/1"
]
}
],
"actions": [
{
"id": 42,
"type": "MEMBER",
"position": 42,
"config": [
"string"
],
"stopOnFailure": true,
"typeLabel": "Primary",
"typeDescription": "Quarterly chapter meeting open to all members."
}
]
}Authorizations
ApiTokenJWT
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Path Parameters
Workflow identifier
Body
application/merge-patch+json
The updated Workflow resource
Example:
"/api/v1/tenants/1"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Workflow resource updated
Example:
"/api/v1/users/1"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I