Run

One execution by the integrations service (1.60.0): identity, outcome, timing and size, and keyed hashes; never a value or a credential. Content of a Run inside a Call lives once, in the Call's tool.invoked and tool.completed records under the transcript's rules.

An object with 39 fields.

Fields

Field	Type	Required	Description
`arguments_hmac`	KeyedHash or null	yes
`attempts`	integer	yes
`binding_sha256`	Sha256Hex or null	yes
`breaker_state`	BreakerState or null	yes
`call_id`	CallId or null	yes
`connection_id`	ConnectionId	yes
`connector_id`	ConnectorId or null	yes
`connector_version`	string or null	yes
`contract_sha256`	Sha256Hex or null	yes
`created_at`	Timestamp	yes
`ended_at`	Timestamp	yes
`environment`	Environment	yes
`error_code`	ToolErrorCode or null	yes	Null when `ok`.
`id`	RunId	yes
`idempotency_key_hmac`	KeyedHash or null	yes
`job_id`	JobId or null	yes
`kind`	RunKind	yes
`mcp_server_id`	McpServerId or null	yes
`message_id`	MessageId or null	yes
`mock`	boolean	yes	True when the Connector's mock ran instead of the vendor (`test`).
`object`	`"run"`	yes
`organization_id`	OrganizationId	yes
`overhead_ms`	integer	yes	The exec role's own time, excluding the vendor's, a measurement.
`queued_ms`	integer	yes
`rate_limit_wait_ms`	integer	yes
`request_bytes`	integer	yes
`response_bytes`	integer	yes
`result_hmac`	KeyedHash or null	yes
`retry_causes`	array of RetryCause	yes	Why each retry was sent, such as `connect_failed` or `http_503`.
`started_at`	Timestamp	yes
`status`	RunStatus	yes
`tool`	UpstreamToolName or null	yes
`tool_binding_id`	ToolBindingId or null	yes
`tool_call_id`	ToolCallId or null	yes
`tool_id`	ToolId or null	yes
`trigger_event_id`	TriggerEventId or null	yes
`vendor_error_code`	string or null	yes	The vendor's error, normalized by the Connector to a snake_case code; never its text.
`vendor_http_status`	integer or null	yes
`vendor_ms`	array of AttemptMs	yes	The vendor time of each attempt, a measurement.

Used by

The operations whose parameters, request body or responses name this shape directly.

GET /v1/runs/{run_id}