Endpoints
DEVELOPER REFERENCE
Update workflow
PATCH /workflows/{workflowId}
Change workflow metadata. Supply at least one of name, icon or iconColor. name must be non-empty after trimming. Use the graph endpoint for node and connection edits.
PATCH /api/v1/workflows/{workflowId}Permission: workflows:write. Write endpoints also require a workspace role that permits changes. See authentication and errors.
Request
curl --request PATCH 'https://app.innflow.ai/api/v1/workflows/workflow_id' \
--header "Authorization: Bearer $INNFLOW_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"name": "Updated workflow"
}'Examples use placeholder IDs. Set INNFLOW_API_KEY in your shell and replace IDs with your own before sending a request.
Parameters
| Name | In | Required | Details |
|---|---|---|---|
workflowId | path | Yes | Resource identifier. |
X-Innflow-Workspace | header | No | Organization ID, or personal. Set explicitly; omission uses legacy user-owned resource scope. |
JSON body
Required JSON body.
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"icon": {
"type": [
"string",
"null"
]
},
"iconColor": {
"type": [
"string",
"null"
]
}
}
}Response
HTTP 200 — Returns data with id, name, icon, iconColor, deploymentStatus, deployedAt, createdAt and updatedAt.
See OpenAPI download for the machine-readable request contract and errors for errors and retry behavior.