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>"
}'

Request#

DeleteWorkflowRequest#

FieldTypeDescription
idstring

Which archived workflow to remove for good, with whatever is still inside it.

required

Response#

Empty#

No fields.