Analytics

List Flow Runs

get

List flow run logs matching the given filters.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Authorization header. Learn how to get it.

Token URL:

Path parameters

flow_idstringRequired

org_idstringRequired

Query parameters

pageintegerOptionalDefault: 0

page_sizeinteger · min: 1OptionalDefault: 25

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

user_idstring · nullableOptional

statestring · nullableOptional

Comma-separated list of statuses to filter by. Accepted values: PENDING, PAUSED, RESUMED, COMPLETED, FAILED, CANCELLED

Responses

200

Successful Response

application/json

Summary of a single workflow run.

run_idstring · uuidRequired

conversation_idstring · nullableOptional

datestring · date-timeRequired

is_flow_successfulboolean · nullableRequired

statestring · enum · nullableRequired

Enum representing the possible states of a workflow.

Possible values:

errorstring · nullableRequired

latencynumber · nullableRequired

total_tokensintegerRequired

user_idstring · nullableRequired

inputsstring · nullableRequired

outputsstring · nullableRequired

llmsstring · nullableRequired

feedbackstring · nullableRequired

run_typestring · enum · nullableOptional

How the run was initiated.

Possible values:

ran_by_typestring · enum · nullableOptional

Who authenticated the run.

Possible values:

ran_by_idstring · uuid · nullableOptional

ID of the user or API key that triggered the run.

ran_by_display_namestring · nullableOptional

Display name of the user (email) or API key (name) that triggered the run.

parent_run_idstring · uuid · nullableOptional

Run ID of the parent workflow for sub-workflow runs.

parent_project_idstring · nullableOptional

Project ID of the parent workflow for sub-workflow runs.

parent_project_namestring · nullableOptional

Name of the parent project for sub-workflow runs.

422

Validation Error

application/json

get/analytics/org/{org_id}/flows/{flow_id}

HTTPcURLJavaScriptPython

GET /analytics/org/{org_id}/flows/{flow_id} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "run_id": "123e4567-e89b-12d3-a456-426614174000",
    "conversation_id": "text",
    "date": "2026-08-07T11:28:36.386Z",
    "is_flow_successful": true,
    "state": "PENDING",
    "error": "text",
    "latency": 1,
    "total_tokens": 1,
    "user_id": "text",
    "inputs": "text",
    "outputs": "text",
    "llms": "text",
    "feedback": "text",
    "llm_usage": [
      {
        "provider": "Anthropic",
        "model_id": "text",
        "tokens": 1,
        "input_tokens": 1,
        "output_tokens": 1,
        "connection_id": "123e4567-e89b-12d3-a456-426614174000",
        "connection_origin": "stack_ai",
        "is_local_model": true,
        "should_charge": true
      }
    ],
    "run_type": "workflow_builder",
    "ran_by_type": "user",
    "ran_by_id": "123e4567-e89b-12d3-a456-426614174000",
    "ran_by_display_name": "text",
    "parent_run_id": "123e4567-e89b-12d3-a456-426614174000",
    "parent_project_id": "text",
    "parent_project_name": "text"
  }
]

List Project Run Summary

get

Org-level analytics for all projects. List with the project run logs matching the given filters.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Authorization header. Learn how to get it.

Token URL:

Query parameters

pageintegerOptionalDefault: 0

page_sizeinteger · min: 1OptionalDefault: 25

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

Responses

200

Successful Response

application/json

A row with information about project run summary at the organization level.

project_idstringRequired

project_typestringRequired

project_namestringRequired

total_runsintegerRequired

total_errorsintegerRequired

total_tokensintegerRequired

total_usersintegerRequired

is_publishedbooleanRequired

public_ui_urlstring · nullableRequired

public_ui_typestring · nullableRequired

422

Validation Error

application/json

get/organizations/analytics/projects-run-summary

HTTPcURLJavaScriptPython

GET /organizations/analytics/projects-run-summary HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "project_id": "text",
    "project_owner": {
      "user_id": "text",
      "email": "text",
      "avatar_url": "https://example.com"
    },
    "project_type": "text",
    "project_name": "text",
    "total_runs": 1,
    "total_errors": 1,
    "total_tokens": 1,
    "total_users": 1,
    "is_published": true,
    "public_ui_url": "text",
    "public_ui_type": "text"
  }
]