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

NameInRequiredDetails
workflowIdpathYesResource identifier.
X-Innflow-WorkspaceheaderNoOrganization 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.

On this page