Skip to content

REST API — Workflows

Method Path What it does
GET /api/workflows List workflows for the current user, including system workflows.
POST /api/workflows Create a new workflow.
GET /api/workflows/executions/{execution_id} Get execution status and results (checks both user and system workflows).
POST /api/workflows/executions/{execution_id}/respond Send a clarification response to a waiting workflow (Temporal signal).
POST /api/workflows/extract-requirements Extract multiple requirement values from a user message using LLM.
POST /api/workflows/odds Fetch NHL odds for a given date from FanDuel.
GET /api/workflows/palette Get UI-friendly palette data for workflow editor drag-drop.
GET /api/workflows/registry Get available tools, capabilities, and agents for workflow nodes.
GET /api/workflows/system/{workflow_id}/executions List execution history for a system workflow (user-scoped).
POST /api/workflows/system/{workflow_id}/run Run a system workflow (code-defined, not database-stored).
DELETE /api/workflows/{workflow_id} Delete a specific workflow. Owner only.
GET /api/workflows/{workflow_id} Get workflow details by ID (scoped to the selected workspace).
PATCH /api/workflows/{workflow_id} Update a specific workflow. Owner only.
GET /api/workflows/{workflow_id}/embed-tokens List embed tokens for a workflow. Owner or member can view.
POST /api/workflows/{workflow_id}/embed-tokens Create an embed token for external widget embedding. Owner only.
DELETE /api/workflows/{workflow_id}/embed-tokens/{token_id} Delete an embed token. Owner only.
PATCH /api/workflows/{workflow_id}/embed-tokens/{token_id} Update an embed token. Owner only.
GET /api/workflows/{workflow_id}/executions List recent executions for a workflow. Any member can view.
POST /api/workflows/{workflow_id}/run Run a workflow. Uses active version by default, or specified version_id. Owner or member can run.
GET /api/workflows/{workflow_id}/tokens List webhook tokens for a workflow. Owner or member can view.
POST /api/workflows/{workflow_id}/tokens Create a new webhook token for a workflow. Owner only.
DELETE /api/workflows/{workflow_id}/tokens/{token_id} Delete a webhook token. Owner only.
PATCH /api/workflows/{workflow_id}/tokens/{token_id} Enable or disable a webhook token. Owner only.
GET /api/workflows/{workflow_id}/versions List all versions of a workflow. Any member can view.
POST /api/workflows/{workflow_id}/versions Create a new workflow version. Owner only.
POST /api/workflows/{workflow_id}/versions/{version_id}/activate Activate a specific workflow version (deactivates others). Owner only.
POST /auth/workflow-ticket/{execution_id} Create a short-lived ticket for WebSocket auth.