delete_flow - kubed-io/selenium-flow GitHub Wiki

delete_flow

Delete one of this workspace's flows.

MCP tool delete_flow
HTTP DELETE /flows/{name}

Deleting one that is not there is not an error. A flow in the shared global library is not yours to delete — every workspace runs those, so one vanishing mid-run would break somebody else's work — and asking is refused rather than silently ignored.

Parameters

Name Type Required Default
name string yes —

Every call names its workspace: an X-Workspace header, or ?workspace=<name>. Sending both is refused. See Workspaces.

Returns

Field Type Notes
deleted boolean False when there was no such flow, which is not an error.
workspace string
name string

Errors

Status Means
400 The request cannot succeed as sent — an unusable name, a flow that does not exist, a document that would not run, or a write aimed at the read-only shared library. Do not retry it unchanged.
401 Missing or wrong bearer token.
500 Something failed that this server did not expect.

Over MCP the same failures arrive as a tool error.

Example

MCP

delete_flow(name="…")

HTTP

curl -X DELETE $SELENIUM_FLOW/flows/my-flow \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Workspace: $WORKSPACE"

← All actions · Installing · Deployment

⚠️ **GitHub.com Fallback** ⚠️