Workflows

Get workflow status

Returns the current status of a similarity or propensity audience workflow run. Poll this endpoint after creating a similarity or propensity audience to track progress. Use wait_for_workflow (MCP) for a blocking poll, or call this endpoint directly for non-blocking status checks. Only runs owned by the caller's organization are accessible; other IDs return 404. Requires 'discovery' scope.

get/v1/workflows/{workflow_run_id}

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/workflows/{workflow_run_id}
  • Auth: HTTP bearer

Path parameters

workflow_run_idstring required

The workflow run ID returned in the POST /v1/audiences response.

Response

Workflow status.

workflow_run_idstring
status'running' | 'paused' | 'completed' | 'failed'

running = steps executing normally; paused = waiting for HITL gate response (only when hitl=true); completed = workflow finished, audience is active; failed = workflow encountered an unrecoverable error.

current_stepinteger

Current step index (1-based).

step_countinteger

Total number of steps in the workflow.

Changes

No recorded changes to this operation across all 1 revision of this API.