Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

Create workflow

POST /api/agent-workflows

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

REST requestbash

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

Response

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

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.