mcpDeterministic

Create workflow

tools/call

Create a new empty workflow shell in the workspace. Returns the freshly-minted workflow with an empty workflow_definition that you then populate via update-workflow (or by routing through compile-workflow-from-prompt). For prompt-driven creation, prefer compile-workflow-from-prompt followed by create-workflow + update-workflow.

Parameters

workspaceId
string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
namerequired
string
Human-friendly workflow name.
description
string
Optional one-liner describing what the workflow does.
workspace_id
string
Workspace UUID. Optional with API key auth - inferred from the key.

Example

MCP tools/calljson
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create-workflow",
"arguments": {
"name": "example"
}
}
}

Response

The operation is available, but its typed response schema has not been published yet.

JSON-RPC errors

-32602
Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001
Authentication or hosted AI consent is required.
-32003
Workspace access is denied.
-32029
The request was rate limited.
Pipeline MCP documentation | Pipeline