Skip to main content
PATCH
/
api
/
v1
/
workflows
/
{id}
Update Workflow
curl --request PATCH \
  --url https://api.example.com/api/v1/workflows/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "triggerType": "<string>",
  "triggerConfig": {},
  "steps": [
    {}
  ],
  "enabled": true
}
'
{
  "workflow": {}
}

​
Authentication

Requires a Bearer token with tools scope. See Authentication.

​
Path Parameters

​
id
string
required
The workflow UUID.

​
Request

All fields are optional — include only what you want to change.
​
name
string
Display name for the workflow.
​
triggerType
string
How the workflow is triggered (e.g., manual, schedule, event).
​
triggerConfig
object
Trigger configuration (schedule expression, event pattern, etc.).
​
steps
array
Ordered list of workflow steps.
​
enabled
boolean
Enable or disable the workflow.

​
Response

​
workflow
object
The updated workflow object.

​
Example

curl
curl -X PATCH https://www.hitheo.ai/api/v1/workflows/wf_abc123 \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'