delete-process-flow

Delete a process flow from this project by id. Irreversible: the process flow goes with its agents and wiring. Needs the fabric:flow.delete grant.

curl -sS -X POST https://fabric.wexa.ai/mcp/$FABRIC_PROJECT_ID \
  -H "authorization: Bearer $FABRIC_API_KEY" \
  -H "Mcp-Session-Id: $MCP_SESSION_ID" \
  -H "content-type: application/json" -H "accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"delete-process-flow","arguments":{"process_flow_id":"6ab196817566f41b5c28e33a"}}}'

{
  "content": [
    {
      "type": "text",
      "text": "{\"lifecycle_id\":\"qlc_000210\",\"result\":{\"deleted\":true,\"name\":\"docs-fixture-scratch-flow-1790023297678\",\"process_flow_id\":\"6ab196817566f41b5c28e33a\",\"running_executions\":\"not cancelled — deletion is not gated on execution state\"}}"
    }
  ],
  "isError": false
}

curl -sS https://fabric.wexa.ai/v1/delete-process-flow \
  -H "authorization: Bearer $FABRIC_API_KEY" \
  -H "content-type: application/json" \
  -d '{"process_flow_id":"6ab196817566f41b5c28e33a"}'

{
  "lifecycle_id": "qlc_000210",
  "result": {
    "deleted": true,
    "name": "docs-fixture-scratch-flow-1790023297678",
    "process_flow_id": "6ab196817566f41b5c28e33a",
    "running_executions": "not cancelled — deletion is not gated on execution state"
  }
}

import { Fabric } from '@wexa-fabric/sdk'

const fabric = new Fabric()
const result = await fabric.deleteProcessFlow({
  process_flow_id: '6ab196817566f41b5c28e33a'
})

// result is the payload itself, with no `.result` to read
{
  deleted: true,
  name: 'docs-fixture-scratch-flow-1790023297678',
  process_flow_id: '6ab196817566f41b5c28e33a',
  running_executions: 'not cancelled — deletion is not gated on execution state'
}

from wexa import Fabric

fabric = Fabric()
out = fabric.delete_process_flow(
    process_flow_id="6ab196817566f41b5c28e33a",
)

# out is the result, already unwrapped
{
    "deleted": True,
    "name": "docs-fixture-scratch-flow-1790023297678",
    "process_flow_id": "6ab196817566f41b5c28e33a",
    "running_executions": "not cancelled — deletion is not gated on execution state"
}

Parameters

Parameter	Type	Required	Notes
`process_flow_id`	string	Required	Process flow id to delete. Address it by id: `get-process-flow` resolves a name to one. A process flow in this project.

Show full response

A real response, captured from a live call to delete-process-flow:

{
  "lifecycle_id": "qlc_000210",
  "result": {
    "deleted": true,
    "name": "docs-fixture-scratch-flow-1790023297678",
    "process_flow_id": "6ab196817566f41b5c28e33a",
    "running_executions": "not cancelled \u2014 deletion is not gated on execution state"
  }
}

// the object you get back IS the result — there is no `.result` to read
{
  deleted: true,
  name: 'docs-fixture-scratch-flow-1790023297678',
  process_flow_id: '6ab196817566f41b5c28e33a',
  running_executions: 'not cancelled — deletion is not gated on execution state'
}

// The TS SDK names these camelCase — lifecycleId, traceId — where Python uses
// lifecycle_id and trace_id. Both are non-enumerable: readable, but omitted by
// Object.keys() and JSON.stringify(). `result.lifecycleId` here is undefined.
result.lifecycleId // 'qlc_000210'

# a dict subclass; `result` is already unwrapped
{
 "deleted": True,
 "name": "docs-fixture-scratch-flow-1790023297678",
 "process_flow_id": "6ab196817566f41b5c28e33a",
 "running_executions": "not cancelled \u2014 deletion is not gated on execution state"
}

out.lifecycle_id  # 'qlc_000210' — an attribute, not a key

More details

There is no undo. Deletion is not gated on execution state: a run already in flight is neither cancelled nor waited for, so stop anything you care about first. A process flow that does not exist in this project is a 404, not a success.

It also removes the emptied container an agent leaves behind: pass the container half of an agent id (the part before the dot) when delete-agent reports container_remains.

Marked consequential: it is audited in full, and a policy rule may hold it for a person to approve. See Policy and approvals.

Every tool call works the same way: How every tool call works.