commit_workflow
Lock a workflow draft as a read-only committed version, making it deployable. Required before deployment to ensure the live version is stable.
Instructions
Commit the current draft of a workflow/pipeline, locking it as a read-only version that can be deployed.
REQUIRED before deploy_workflow. The deploy endpoint rejects calls if no committed version exists. Calls POST /api/workflows/{id}/commits/ (the correct platform endpoint — different from the SDK's createWorkflowVersion which doesn't actually commit).
Flow:
create_workflow (or create_evaluation_pipeline) — creates a draft
commit_workflow — locks current draft as read-only
deploy_workflow — makes the committed version live
Applies to automations, monitors, export workflows, and evaluator pipelines.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workflow_id": "<workflow_id>"
},
"name": "commit_workflow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | No | Commit message / version description. | |
| workflow_id | Yes | Family workflow_id (not a version-row id). |