Skip to main content
POST
Cancel 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

id
string
required

The run id.

Minimum string length: 1

Response

200 - application/json

Success

id
string
required

The run id.

name
string | null
required

What the run was called, if anything.

sql
string
required

The statement, exactly as submitted.

parameters
object
required

The values the statement's parameters were filled with.

questions
object[]
required

One entry per eval function the statement projects, derived from it when the run was accepted.

limit
integer
required

Rows this run may judge.

status
enum<string>
required

Where the run is in its life.

Available options:
queued,
planning,
running,
finished,
failed,
cancelled
total
integer | null
required

Rows the run found, bounded by its limit. Null until it has looked.

progress
integer
required

Rows judged so far.

matched
integer | null
required

Judgements that matched, across this run's boolean questions. Null when the run asked none: a score or a category question has no match to count.

matchedByQuestion
object
required

Per question: matches for a boolean question, judged rows for a score or a category one.

failed
integer
required

Rows the judge could not answer.

skipped
integer
required

Rows the judge declined to answer.

tokens
integer
required

Input tokens the judge billed for.

costUsd
number
required

What the judging cost us, in United States dollars.

priceUsd
number
required

What the judging costs you, in United States dollars.

error
string | null
required

The code of the failure that ended the run, when one did.

createdAt
string
required

When the run was accepted.

updatedAt
string
required

When the run was last written to.

startedAt
string | null
required

When the run began reading rows.

finishedAt
string | null
required

When the run ended.

Last modified on September 19, 2026