Workflows v2 (Plays) / REST API

Create workflow

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.

POST /api/agent-workflowsDeterministic operation

Parameters

workspaceIdOptional · 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.
descriptionOptional · string: Optional one-liner describing what the workflow does.
workspace_idOptional · string: Workspace UUID. Optional with API key auth - inferred from the key.

Request example

curl -X POST "https://app.pipeline.help/api/agent-workflows" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"example"}'

Full input schema

Input schema

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "name": {
      "type": "string",
      "description": "Human-friendly workflow name."
    },
    "description": {
      "type": "string",
      "description": "Optional one-liner describing what the workflow does."
    },
    "workspace_id": {
      "type": "string",
      "description": "Workspace UUID. Optional with API key auth - inferred from the key."
    }
  },
  "required": [
    "name"
  ]
}

See this operation inCLI MCP TypeScript SDK