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

apiDeterministic

List plays

GET /api/agent-workflows/plays

List every system play available across the platform. A "play" is a reusable, system-shipped step (source, enrichment, qualification, copy, routing, destination) that workflows compose into pipelines. Each entry returns id, name, description, category, sideEffectLevel, agent role, required tools, and the approval policy. Read-only and global (no workspace scoping). Use this BEFORE compile-workflow-from-prompt to see what building blocks the compiler can choose from.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/agent-workflows/plays" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

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.