Skip to main content
GET
Get a run's current status, including its tool invocations

Authorizations

Authorization
string
header
required

Clerk session token, Authorization: Bearer <token> — the first-party browser app's own auth. Used only by this internal /api/v1/* surface, never by /api/public/v1/*.

Path Parameters

runId
string
required
Minimum string length: 1

Response

The run.

id
string
required
chatId
string
required
status
enum<string>
required
Available options:
queued,
running,
waiting,
completed,
failed,
cancelled
userMessageId
string
required
assistantMessageId
string | null
required
lastStreamIndex
integer
required
cancelRequestedAt
string | null
required
requestedModel
string
required
resolvedModel
string | null
required
errorCode
string | null
required
errorMessage
string | null
required
createdAt
string
required
updatedAt
string
required
startedAt
string | null
required
finishedAt
string | null
required
toolInvocations
object[]
required
totalCreditsUsed
number
required
Required range: x >= 0
pendingWaitpoint
object
required