Stream session events as Server-Sent Events
curl --request GET \
--url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"anchor_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"content": [
{
"byte_size": 1,
"content": [],
"context": "example",
"data": "example",
"encrypted_content": "example",
"height": 1,
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"input": {
"key": "example"
},
"is_error": true,
"media_type": "example",
"name": "example-name",
"omitted_bytes": 1,
"payload": "example",
"provider": "example",
"provider_payload": "example",
"redacted": true,
"semantic_hint": "example",
"sha256": "example",
"signature": "example",
"source": {
"file_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "file"
},
"summary": [],
"text": "example",
"title": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "example",
"uri": "example",
"url": "https://example.com",
"url_expires_at": "2026-02-18T09:30:00.000Z",
"width": 1
}
],
"error": {
"key": "example"
},
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"processed_at": "2026-02-18T09:30:00.000Z",
"raw_event": {
"actor": "human:api",
"agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"causal_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"content": {
"blocks": [
{
"byte_size": 1,
"content": [],
"context": "example",
"data": "example",
"encrypted_content": "example",
"height": 1,
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"input": {
"key": "example"
},
"is_error": true,
"media_type": "example",
"name": "example-name",
"omitted_bytes": 1,
"payload": "example",
"provider": "example",
"provider_payload": "example",
"redacted": true,
"semantic_hint": "example",
"sha256": "example",
"signature": "example",
"source": {
"file_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "file"
},
"summary": [],
"text": "example",
"title": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "example",
"uri": "example",
"url": "https://example.com",
"url_expires_at": "2026-02-18T09:30:00.000Z",
"width": 1
}
],
"evaluation_budget_reached": {
"affected_target_session_ids": [
"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
],
"max_tree_cost_usd": "example"
},
"evaluation_plan_frozen": {
"criteria": [
{
"criterion_key": "example",
"criterion_text": "example"
}
],
"max_concurrent_threads": 1,
"max_tree_cost_usd": "example",
"targets": [
{
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
}
]
},
"evaluation_run_finished": {
"failure_code": "plan_failed",
"failure_message": "example",
"targets_budget_reached": 1,
"targets_skipped": 1,
"targets_total": 1,
"terminal_status": "completed",
"verdicts_recorded": 1
},
"evaluation_target_skipped": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"reason": "example",
"reason_code": "child_create_failed",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"evaluation_target_started": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"clone_state": "ready",
"evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"sandbox_provider": "example",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"evaluation_verdict_recorded": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"cost_completeness": "complete",
"cost_usd": "example",
"evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"failed_criterion_keys": [
"example"
],
"result": "pass",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"metadata": {
"key": "example"
},
"plan": [
{
"content": "example",
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"status": "example"
}
],
"stop_reason": "example",
"tools": [
{
"description": "example",
"input_schema": {
"key": "example"
},
"name": "example-name"
}
],
"usage": {
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"cost_usd": 1.5,
"input_tokens": 1,
"output_tokens": 1
}
},
"content_hydration_status": "hydrated",
"content_payload_bytes": 1,
"content_payload_ref": "example",
"content_payload_sha256": "example",
"content_ref": "example",
"cost_micros": 1,
"created_at": "2026-02-18T09:30:00.000Z",
"environment_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"event_status": "example",
"event_type": "example",
"finish_reason": "example",
"inference_config": {
"max_tokens": 1,
"provider_params": {
"key": "example"
},
"reasoning_effort": "example",
"temperature": 1.5,
"top_p": 1.5
},
"input_tokens": 1,
"latency_ms": 1,
"model": {
"base_url": "https://example.com",
"capabilities": {
"key": "example"
},
"context_window": 1,
"max_output_tokens": 1,
"metadata": {
"key": "example"
},
"model": "example",
"model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"model_version": "example",
"provider": "example",
"provider_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_type": "example",
"serving_backend": "example"
},
"model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"output_tokens": 1,
"parent_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"prompt_tokens": 1,
"provider_model_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_request_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_type": "example",
"role": "user",
"sandbox_instance_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"schema_version": 1,
"session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"thread_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"tool_name": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"turn_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"session_thread_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"stop_reason": "example",
"type": "example",
"usage": {
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"cost_usd": 1.5,
"input_tokens": 1,
"output_tokens": 1
}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "forbidden",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "bad_gateway",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "gateway_timeout",
"message": "<string>",
"details": {}
}Sessions
Stream session events as Server-Sent Events
Streams the session’s events as Server-Sent Events, resuming from after_event_id or the Last-Event-ID header when either is present. The query cursor takes precedence. Clients that set after_event_id must replace it with their latest event id, or remove it to use Last-Event-ID, on every reconnect; reusing the original URL replays events after its fixed cursor. The selected cursor must be a lowercase canonical UUID or the request returns 400. The stream closes by itself once the session reaches a terminal status. Each stream holds a server-side slot for its whole lifetime and is capped separately from the request rate, so close it when you are done.
GET
/
managed-agents
/
v1
/
sessions
/
{session_id}
/
events
/
stream
Stream session events as Server-Sent Events
curl --request GET \
--url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/events/stream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"anchor_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"content": [
{
"byte_size": 1,
"content": [],
"context": "example",
"data": "example",
"encrypted_content": "example",
"height": 1,
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"input": {
"key": "example"
},
"is_error": true,
"media_type": "example",
"name": "example-name",
"omitted_bytes": 1,
"payload": "example",
"provider": "example",
"provider_payload": "example",
"redacted": true,
"semantic_hint": "example",
"sha256": "example",
"signature": "example",
"source": {
"file_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "file"
},
"summary": [],
"text": "example",
"title": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "example",
"uri": "example",
"url": "https://example.com",
"url_expires_at": "2026-02-18T09:30:00.000Z",
"width": 1
}
],
"error": {
"key": "example"
},
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"processed_at": "2026-02-18T09:30:00.000Z",
"raw_event": {
"actor": "human:api",
"agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"causal_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"content": {
"blocks": [
{
"byte_size": 1,
"content": [],
"context": "example",
"data": "example",
"encrypted_content": "example",
"height": 1,
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"input": {
"key": "example"
},
"is_error": true,
"media_type": "example",
"name": "example-name",
"omitted_bytes": 1,
"payload": "example",
"provider": "example",
"provider_payload": "example",
"redacted": true,
"semantic_hint": "example",
"sha256": "example",
"signature": "example",
"source": {
"file_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "file"
},
"summary": [],
"text": "example",
"title": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"type": "example",
"uri": "example",
"url": "https://example.com",
"url_expires_at": "2026-02-18T09:30:00.000Z",
"width": 1
}
],
"evaluation_budget_reached": {
"affected_target_session_ids": [
"9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
],
"max_tree_cost_usd": "example"
},
"evaluation_plan_frozen": {
"criteria": [
{
"criterion_key": "example",
"criterion_text": "example"
}
],
"max_concurrent_threads": 1,
"max_tree_cost_usd": "example",
"targets": [
{
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
}
]
},
"evaluation_run_finished": {
"failure_code": "plan_failed",
"failure_message": "example",
"targets_budget_reached": 1,
"targets_skipped": 1,
"targets_total": 1,
"terminal_status": "completed",
"verdicts_recorded": 1
},
"evaluation_target_skipped": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"reason": "example",
"reason_code": "child_create_failed",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"evaluation_target_started": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"clone_state": "ready",
"evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"sandbox_provider": "example",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"evaluation_verdict_recorded": {
"child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"cost_completeness": "complete",
"cost_usd": "example",
"evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"failed_criterion_keys": [
"example"
],
"result": "pass",
"snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"metadata": {
"key": "example"
},
"plan": [
{
"content": "example",
"id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"status": "example"
}
],
"stop_reason": "example",
"tools": [
{
"description": "example",
"input_schema": {
"key": "example"
},
"name": "example-name"
}
],
"usage": {
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"cost_usd": 1.5,
"input_tokens": 1,
"output_tokens": 1
}
},
"content_hydration_status": "hydrated",
"content_payload_bytes": 1,
"content_payload_ref": "example",
"content_payload_sha256": "example",
"content_ref": "example",
"cost_micros": 1,
"created_at": "2026-02-18T09:30:00.000Z",
"environment_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"event_status": "example",
"event_type": "example",
"finish_reason": "example",
"inference_config": {
"max_tokens": 1,
"provider_params": {
"key": "example"
},
"reasoning_effort": "example",
"temperature": 1.5,
"top_p": 1.5
},
"input_tokens": 1,
"latency_ms": 1,
"model": {
"base_url": "https://example.com",
"capabilities": {
"key": "example"
},
"context_window": 1,
"max_output_tokens": 1,
"metadata": {
"key": "example"
},
"model": "example",
"model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"model_version": "example",
"provider": "example",
"provider_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_type": "example",
"serving_backend": "example"
},
"model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"output_tokens": 1,
"parent_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"prompt_tokens": 1,
"provider_model_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_request_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"provider_type": "example",
"role": "user",
"sandbox_instance_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"schema_version": 1,
"session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"thread_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"tool_name": "example",
"tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"turn_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
},
"session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"session_thread_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
"stop_reason": "example",
"type": "example",
"usage": {
"cache_read_tokens": 1,
"cache_write_tokens": 1,
"cost_usd": 1.5,
"input_tokens": 1,
"output_tokens": 1
}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "forbidden",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "bad_gateway",
"message": "<string>",
"details": {}
}{
"code": "analytics",
"message": "<string>",
"details": {}
}{
"code": "gateway_timeout",
"message": "<string>",
"details": {}
}Authorizations
A Recursion API key, created in the console under API keys.
Headers
Exclusive lowercase canonical UUID event cursor used when after_event_id is absent. Malformed selected cursors return 400.
Pattern:
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Path Parameters
Session id (UUID) whose events are streamed.
Query Parameters
Exclusive lowercase canonical UUID event cursor. Takes precedence over Last-Event-ID. Clients that set this query parameter must replace it with their latest event id, or remove it to use Last-Event-ID, on every reconnect. Malformed selected cursors return 400.
Comma-separated managed event type filter.
Opt in to inline image hydration. Event payload hydration is independent and enabled by default.
Available options:
images Set to signed to add a short-lived url (and url_expires_at) to stored image blocks within the per-read signing budget. Omitted when signing is unavailable or the budget is exhausted; the authenticated getSessionImage endpoint always works.
Available options:
signed Set refs to stream external event stubs without resolving payload JSON.
Available options:
refs Response
One JSON payload from the managed session event stream. Durable timeline events include their reconnectable id and raw event; synthetic lifecycle and error events carry only the applicable compatibility fields.
One JSON payload from the managed session event stream. Durable timeline events include their reconnectable id and raw event; synthetic lifecycle and error events carry only the applicable compatibility fields.
Managed event type emitted in both the SSE event field and this JSON payload.
Durable event id this event is anchored to, when supplied by event metadata.
Content blocks projected from the durable source event.
Show child attributes
Show child attributes
Public failure details for a failed event or session, or reconnect guidance after a stream read error.
Show child attributes
Show child attributes
Durable source event id used as the SSE id and reconnect cursor. Omitted for synthetic status and error events.
RFC 3339 timestamp when the durable event was created or the synthetic status event was projected.
Unmodified durable event backing this compatibility projection. Omitted for synthetic status and error events.
Show child attributes
Show child attributes
Example:
{ "actor": "human:api", "agent_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "cache_read_tokens": 1, "cache_write_tokens": 1, "causal_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "content": { "blocks": [ { "byte_size": 1, "content": [], "context": "example", "data": "example", "encrypted_content": "example", "height": 1, "id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "input": { "key": "example" }, "is_error": true, "media_type": "example", "name": "example-name", "omitted_bytes": 1, "payload": "example", "provider": "example", "provider_payload": "example", "redacted": true, "semantic_hint": "example", "sha256": "example", "signature": "example", "source": { "file_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "type": "file" }, "summary": [], "text": "example", "title": "example", "tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "type": "example", "uri": "example", "url": "https://example.com", "url_expires_at": "2026-02-18T09:30:00.000Z", "width": 1 } ], "evaluation_budget_reached": { "affected_target_session_ids": ["9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"], "max_tree_cost_usd": "example" }, "evaluation_plan_frozen": { "criteria": [ { "criterion_key": "example", "criterion_text": "example" } ], "max_concurrent_threads": 1, "max_tree_cost_usd": "example", "targets": [ { "snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d" } ] }, "evaluation_run_finished": { "failure_code": "plan_failed", "failure_message": "example", "targets_budget_reached": 1, "targets_skipped": 1, "targets_total": 1, "terminal_status": "completed", "verdicts_recorded": 1 }, "evaluation_target_skipped": { "child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "reason": "example", "reason_code": "child_create_failed", "snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d" }, "evaluation_target_started": { "child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "clone_state": "ready", "evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "sandbox_provider": "example", "snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d" }, "evaluation_verdict_recorded": { "child_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "cost_completeness": "complete", "cost_usd": "example", "evaluation_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "failed_criterion_keys": ["example"], "result": "pass", "snapshot_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "target_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d" }, "metadata": { "key": "example" }, "plan": [ { "content": "example", "id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "status": "example" } ], "stop_reason": "example", "tools": [ { "description": "example", "input_schema": { "key": "example" }, "name": "example-name" } ], "usage": { "cache_read_tokens": 1, "cache_write_tokens": 1, "cost_usd": 1.5, "input_tokens": 1, "output_tokens": 1 } }, "content_hydration_status": "hydrated", "content_payload_bytes": 1, "content_payload_ref": "example", "content_payload_sha256": "example", "content_ref": "example", "cost_micros": 1, "created_at": "2026-02-18T09:30:00.000Z", "environment_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "event_status": "example", "event_type": "example", "finish_reason": "example", "inference_config": { "max_tokens": 1, "provider_params": { "key": "example" }, "reasoning_effort": "example", "temperature": 1.5, "top_p": 1.5 }, "input_tokens": 1, "latency_ms": 1, "model": { "base_url": "https://example.com", "capabilities": { "key": "example" }, "context_window": 1, "max_output_tokens": 1, "metadata": { "key": "example" }, "model": "example", "model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "model_version": "example", "provider": "example", "provider_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "provider_type": "example", "serving_backend": "example" }, "model_ref_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "organization_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "output_tokens": 1, "parent_event_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "prompt_tokens": 1, "provider_model_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "provider_request_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "provider_type": "example", "role": "user", "sandbox_instance_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "schema_version": 1, "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "thread_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "tool_name": "example", "tool_use_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d", "turn_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d" }
Session id associated with the event.
Thread id associated with the durable source event.
Completion, execution, or session-status reason. Durable events use their string stop reason; synthetic status events use an object with a type field.
Model token usage projected from the durable source event.
Show child attributes
Show child attributes
Example:
{ "cache_read_tokens": 1, "cache_write_tokens": 1, "cost_usd": 1.5, "input_tokens": 1, "output_tokens": 1 }