Skip to main content
GET
Poll a run

Authorizations

X-Auth-Token
string
header
required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

runId
string
required

Response

Run state

runId
string
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
stopped
progress
number
required

Cells finished so far

total
number
required

Cells in the run

startedAt
number

Unix milliseconds

finishedAt
number

Unix milliseconds; set once the run is no longer running

summary
object

Present when completed

error
string

Stable failure code, present when failed. Not display copy: render your own wording keyed on it.

domainError
object

The full failure envelope, when the failure carried one

traceId
string

Trace id for failures that carry no code, to quote in support