Skip to main content
GET
Get a run

Authorizations

Authorization
string
header
required

An API key of your organization, starting with trk_, sent as Authorization: Bearer <key>.

Path Parameters

id
string
required

Unique identifier of the run.

Response

A coding agent working on your prompt in an isolated sandbox.

A coding agent working on your prompt in an isolated sandbox.

id
string
required

Unique identifier of the run.

input_files
object[]
required
labels
object
required

Labels you attach to the run to find it again, as keys and values, such as { "ticket": "ENG-42" }. We never read them. Keys match ^[A-Za-z0-9_.-]{1,64}$; at most 20 labels with values of up to 256 characters.

agent
object
required

The coding agent and the model it uses.

environment
object
required

What the agent works on.

budget_usd
required
one_shot
boolean
required

Whether the run ends as soon as its first prompt finishes.

time_limit_seconds
integer
required

Longest the run may last, in seconds from when it starts.

Required range: -9007199254740991 <= x <= 9007199254740991
started_at
string
required
last_prompt
object
required

One instruction to the agent and the work it did in response.

status
enum<string>
required

preparing while its sandbox gets ready, working while the agent works on a prompt, idle while it waits for a follow-up prompt.

Available options:
preparing,
working,
idle
idle_timeout_seconds
integer

How long the run waits for a follow-up prompt before it ends, in seconds. Absent for a one-shot run.

Required range: -9007199254740991 <= x <= 9007199254740991