v3

latestOpenAPI 3.1.02026-08-044114182.0 KB
Runs

List a project's prompt run history

Returns paginated prompt runs with status, timestamps, platforms, and task totals. Use a completed run's id as runId on historical analytics reads.

get/prompts/runs

Query parameters

projectIdstring uuid required

Project id. Required on all data endpoints.

statusstring[]

Repeat this parameter or provide comma-separated values to filter by run status.

startedAfterstring date-time
startedBeforestring date-time
completedAfterstring date-time
completedBeforestring date-time
triggeredBy'manual' | 'scheduled'
platformstring[]

Repeat this parameter or provide comma-separated values to filter by platform ID.

sortBy'ordinal' | 'status' | 'startedAt' | 'completedAt' | 'duration'
sortDir'asc' | 'desc'
limitinteger
offsetinteger

Response

Successful response

totalinteger required
limitinteger required
offsetinteger required