.svg?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=dc407af2e287b4714cedea5b8d7abf4d){kind=logo}
MCP tool: update_workflow
Updates an existing workflow’s definition and configuration. This tool allows you to modify workflow steps, activities, triggers, and execution policies while preserving the workflow’s unique identifier.
Example prompt
Update workflow "ticket-escalation-workflow" to add a new notification step and modify the retry policy
Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
| workflowUniqueIdentifier | string | Yes | The unique identifier of the workflow to update |
| name | string | No | The updated name of the workflow |
| teamId | string | No | The team ID that owns this workflow |
| triggerEvent | object | No | The event that triggers this workflow |
| filters | object | No | Filters to apply to the workflow trigger |
| annotations | array | No | Annotations for the workflow |
| workflowDefinition | array | No | The definition of workflow steps |
| executingAgent | string | No | The agent that executes this workflow |
| isActive | boolean | No | Whether the workflow is active |
| metadata | object | No | Additional metadata for the workflow |
Trigger event structure
| Field | Type | Required | Description |
|---|---|---|---|
| uid | string | Yes | The unique identifier of the trigger event |
| eventName | string | Yes | The name of the trigger event |
Workflow step structure
Each step in theworkflowDefinition array contains:
| Field | Type | Required | Description |
|---|---|---|---|
| stepIdentifier | number | Yes | The identifier for this step |
| activity | object | Yes | The activity to execute in this step |
| input | object | Yes | The input parameters for this activity |
| retryPolicy | object | No | The retry policy for this step |
| onFailure | string | No | Action to take on failure (CONTINUE, ABORT, COMPENSATE) |
| isSleepActivity | boolean | No | Whether this is a sleep/wait activity |
| executionTimeout | number | No | Timeout for execution in seconds |
| approver | object | No | Approver configuration for this step |
| dependencies | array | No | Step dependencies |
| filters | object | No | Filters for this step |
Activity structure
| Field | Type | Required | Description |
|---|---|---|---|
| uniqueIdentifier | string | Yes | The unique identifier of the activity |
| version | number | No | The version of the activity |
| autoUpgradeToLatestVersion | boolean | No | Whether to automatically upgrade to the latest version (default: true) |
Retry policy structure
| Field | Type | Required | Description |
|---|---|---|---|
| maximumAttempts | number | No | Maximum number of retry attempts |
| initialInterval | number | No | Initial interval between retries in seconds |
| backoffCoefficient | number | No | Backoff coefficient for retry intervals |
Approver structure
| Field | Type | Required | Description |
|---|---|---|---|
| type | string | No | Type of approver (TEAM or USER) |
| uid | string | No | ID of the approver |
| timeout | number | No | Timeout for approval in seconds |
Response fields
The response will contain the updated workflow with the same structure as theget_workflow tool.
Sample response
{
"data": {
"uid": "WORKFLOW001",
"type": "WORKFLOW",
"subType": "AI_AGENT",
"uniqueIdentifier": "ticket-escalation-workflow",
"name": "Enhanced Ticket Escalation Workflow",
"version": 2,
"triggerEvent": {
"id": "EVENT001",
"name": "ticket.created",
"description": "Triggered when a new ticket is created"
},
"filters": {
"priority": "high",
"team": "support",
"autoEscalate": true,
"escalationThreshold": 15
},
"annotations": [
{
"entityType": "workflow",
"data": {
"tags": ["escalation", "automation", "enhanced"]
},
"relations": []
}
],
"workflowDefinition": [
{
"stepIdentifier": 1,
"activity": {
"name": "send-notification",
"uniqueIdentifier": "notification.activity",
"version": 2,
"autoUpgradeToLatestVersion": true
},
"input": {
"recipients": ["support-team", "senior-agents"],
"message": "High priority ticket requires immediate attention",
"priority": "urgent",
"includeMetrics": true
},
"retryPolicy": {
"maximumAttempts": 5,
"initialInterval": 2000,
"backoffCoefficient": 2.5
},
"onFailure": "CONTINUE",
"isSleepActivity": false,
"executionTimeout": 45000,
"dependencies": [],
"filters": {
"notificationType": "escalation"
}
},
{
"stepIdentifier": 2,
"activity": {
"name": "assign-to-senior-agent",
"uniqueIdentifier": "assignment.activity",
"version": 1,
"autoUpgradeToLatestVersion": true
},
"input": {
"priority": "high",
"skillSet": ["escalation", "technical", "senior"],
"autoAssign": true,
"loadBalancing": true
},
"retryPolicy": {
"maximumAttempts": 3,
"initialInterval": 5000,
"backoffCoefficient": 1.5
},
"onFailure": "ABORT",
"isSleepActivity": false,
"executionTimeout": 60000,
"dependencies": [1],
"filters": {
"agentLevel": "senior"
}
},
{
"stepIdentifier": 3,
"activity": {
"name": "update-ticket-status",
"uniqueIdentifier": "status-update.activity",
"version": 1,
"autoUpgradeToLatestVersion": true
},
"input": {
"status": "escalated",
"comment": "Automatically escalated due to high priority",
"addTimestamp": true
},
"retryPolicy": {
"maximumAttempts": 2,
"initialInterval": 1000,
"backoffCoefficient": 1
},
"onFailure": "CONTINUE",
"isSleepActivity": false,
"executionTimeout": 15000,
"dependencies": [2],
"filters": {}
}
],
"executingAgent": "workflow-engine-v2",
"isActive": true,
"createdAt": "2025-07-24T07:19:10.258Z",
"updatedAt": "2025-07-25T12:50:38.937Z",
"createdBy": "USER001",
"teamId": "TEAM001",
"metadata": {
"description": "Enhanced automated workflow for escalating high-priority tickets",
"tags": ["escalation", "automation", "support", "enhanced"],
"category": "customer-service",
"version": "2.0",
"lastUpdated": "2025-07-25T12:50:38.937Z"
}
},
"status": true,
"message": "Workflow updated successfully!",
"timestamp": "2025-07-25T12:50:38.937Z"
}