Workflow Runs API

Check a workflow run

You can start a workflow from API with the Workflow Execution API, returning the run_id of the workflow in question To check the status of the run, you can use the following API.

response = requests.get(f"{API_BASE_URL}/workflows/{workflow_id}/runs/{run_id}", headers=headers)
run_details = response.json()
run_details

This will return the details of the run - such as

[{'id': 'THE_RUN_ID',
  'status': 'completed',
  'start_time': '2025-04-24T03:18:12.322630Z',
  'end_time': '2025-04-24T03:18:13.048954Z',
  'elapsed_time': 0,
  'error': None,
  'outputs': {'query': 'Hello from Python',
   'model_1': 'Hello there! How can I assist you today?'},
  'all_outputs': {'query': 'Hello from Python',
   'model_1': 'Hello there! How can I assist you today?'},
  'inputs': {'query': 'Hello from Python'}}]

To check the granular status of each step you can check the Workflow Execution Steps API.