Skip to main content
GET
List runs
Returns run summaries for recent workflow executions — status, duration, error message, and per-run counts of console/SDK/fetch events. Each summary carries a runId; pass it to Read a run for the full detail: console output, SDK calls with request/response data, the run’s input and output, and the error stack trace. Logs are retained for 90 days. See Troubleshooting for common runtime errors and fixes.

Authorizations

Authorization
string
header
required

Enter your Zite API key. Format: Bearer <api_key>

Path Parameters

appId
string
required

The app ID.

Query Parameters

workflowId
string

Narrow to a single endpoint/workflow.

status
enum<string>
default:all

Filter by outcome.

Available options:
all,
success,
error
mode
enum<string>
default:both

Which environment to read from.

Available options:
live,
preview,
both
limit
integer

Max runs to return.

Required range: 1 <= x <= 50
hoursAgo
integer
default:24

Lookback window in hours.

Required range: 1 <= x <= 168

Response

Run summaries, newest first

runs
object[]
totalCount
integer
publishedSnapshotId
integer | null

The app's live snapshot. Null when the app has never been published. Live runs execute this snapshot.

latestSnapshotId
integer | null

The app's newest built snapshot. Preview runs execute this one. When it differs from publishedSnapshotId, live traffic runs older code until the app is published.