Skip to main content
GET
List runs
Lists workspace runs from newest to oldest. Use this endpoint to follow answer collection after a run has been accepted. Read access is available from Growth and Agency Growth.
string
required
Bearer token for your team.
string
required
Workspace identifier. The workspace must belong to the token’s team.
integer
default:"20"
Number of runs per page, from 1 to 20.
string
Opaque nextCursor from the previous page. Omit for the first page.

Response

Returns 200 with success, runs, nextCursor, totalCount and activeCount. Counts describe the workspace, not only the returned page. nextCursor: null means there is no further page. Responses are private, no-store. Each run includes identity and timestamps, purpose, priority, nullable scheduledFrequency, questionCount, modelCount, requestedCount, plannedCount, planningCompletedAt, planningFailed, status, counts, terminalCount and progressPercentage. Status is one of QUEUED, PROCESSING, COMPLETED, COMPLETED_WITH_WARNINGS, FAILED, CANCELLED or NO_WORK. counts distinguishes success, warning, failed, cancelled, processing, queued and skipped. Progress is not a guarantee that every requested answer succeeded; inspect the status and outcome counts.

Synthetic request and response

Errors

Invalid cursors or limits return 400 INVALID_PARAMETER; an inaccessible workspace returns 404 BRAND_NOT_FOUND. See Error codes and honor Retry-After on 429.