API Referenceworkflows

Runs Summary

Aggregate run-status counts plus pass_rate and average_duration_seconds.

pass_rate = completed / (completed + failed + cancelled); None when no terminal runs. average_duration_seconds = mean(completed_at - started_at) over completed runs only; None when there are zero completed runs.

Authentication

AuthorizationBearer
Clerk JWT token

Path parameters

workflow_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Query parameters

fromdatetime or nullOptional

Filter runs by created_at >= this ISO datetime.

todatetime or nullOptional

Filter runs by created_at <= this ISO datetime.

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error