delete_workflow
Permanently delete an archived workflow along with whatever archived agents are still inside it, reusing the same worktree-removal handling a direct agent delete uses.
WorkflowwritesidempotentdestructiveMCP tool
The archived schedules that launched into it go too, since nothing else ever removes them and they would keep the workflow alive. Returns not_found if the workflow does not exist or is not archived, and failed_precondition if a schedule inside it was moved from another workflow whose agents still hold it. An agent whose worktree is still being removed, or whose removal failed, is left behind rather than blocking the call, so the workflow can stay archived and be tried again.
Calling it#
curl -X POST http://127.0.0.1:8787/workflow.v1.WorkflowService/DeleteWorkflow \
-H 'Content-Type: application/json' \
-d '{
"id": "<id>"
}'komrad rpc delete-workflow \
--id <string>{
"name": "delete_workflow",
"arguments": {
"id": "<id>"
}
}Offered by the komrad MCP server to orchestrator agents.
Request#
DeleteWorkflowRequest#
| Field | Type | Description |
|---|---|---|
id | string | Which archived workflow to remove for good, with whatever is still inside it. required |
Response#
Empty#
No fields.