Skip to main content
POST
Finish a run

Authorizations

Authorization
string
header
required

Your API key. Tool calls under tools_url use the run token instead.

Path Parameters

id
string
required

The run id.

Body

application/json
output
string
default:""

The agent's final answer. Read by output checks and the rubric judge.

Maximum string length: 65536
idempotency_key
string
Required string length: 1 - 255

Response

The run, status evaluating.

One agent doing one task in one environment.

id
string

Opaque id, starts with run_.

status
enum<string>
Available options:
created,
running,
evaluating,
done,
failed
ended_by
enum<string> | null
Available options:
finish,
idle_timeout,
timeout,
max_calls,
null
error
object | null
environment
object
task
object
agent
object
tools_url
string

The agent's base address for the tools.

mcp_url
string

One MCP address for the Gmail and Slack tools.

tools
object[]
token
string

The run's credential for the tools, tw_run_... Only in the answers of POST /v1/runs and GET /v1/runs/{id}/tools.

now
string<date-time>

Simulated time after the last call.

calls
integer
max_calls
integer
idle_timeout_seconds
integer
timeout_seconds
integer
created_at
string<date-time>
started_at
string<date-time> | null
expires_at
string<date-time>
finished_at
string<date-time> | null
scored_at
string<date-time> | null
metadata
object
trace
object | null

Every call the tools answered during the run, reads included. Nothing from inside the agent.

evaluation
object | null

The end state and the output compared with the run's checks.