Skip to content
EverrunsEverruns
Everruns Cloud is open in early access. Run agents without operating the platform.

Read one step of a session's trace in full: tool input and output, the model request and response, and its raw events.

GET
/v1/sessions/{session_id}/trace/turns/{turn}/steps/{step}
curl --request GET \
  --url https://app.everruns.com/api/v1/sessions/example/trace/turns/example/steps/example

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
session_id
required
string

Prefixed public identifier

turn
required
string

Prefixed public identifier

step
required
string

Prefixed public identifier

Query Parameters

Section titled “Query Parameters”
full
boolean

Return payloads whole, however large.

Responses

Section titled “ Responses ”

200

Section titled “200”

Success

Media typeapplication/json

Everything about one step, for the inspector.

object
events
required

Raw events of the step, in sequence order.

Array<object>

An event in the session log.

object
data

Payload, when small enough to inline.

id
required

Event identifier.

string
sequence
required

Sequence in the session event log.

integer format: int32
size_bytes
required

Size of the serialized payload.

integer format: int32
ts
required

When the event happened.

string format: date-time
type
required

Event type, such as tool.call_completed.

string
input
One of:

Tool arguments.

object
preview

The first part of the serialized value, when it was cut.

string | null
size_bytes
required

Size of the serialized value.

integer
truncated
required

Whether the value was cut to preview.

boolean
value

The value, when it fits or full was asked for.

output
One of:

Tool result, or error.

object
preview

The first part of the serialized value, when it was cut.

string | null
size_bytes
required

Size of the serialized value.

integer
truncated
required

Whether the value was cut to preview.

boolean
value

The value, when it fits or full was asked for.

request
One of:

The request of a model call: what changed since the previous call.

object
message_count
required

Messages sent in the call.

integer format: int32
new_from
required

Messages before this index were already in the previous call.

integer format: int32
new_messages
required

The new messages, at most 50.

Array<object>

One message of a model request.

object
content

The whole message, when asked for and within the limit.

index
required

Position in the request.

integer format: int32
preview
required

Start of the message text.

string
role
required

system, user, assistant or tool.

string
size_bytes
required

Size of the serialized message.

integer
system_preview

Start of the system prompt.

string | null
tool_count
required

Tools offered in the call.

integer format: int32
step
required

The step itself.

object
child_session_id

Session a spawn_agent call started.

string | null
duration_ms

Wall time of the step; absent while running.

integer | null format: int64
end_sequence

Last event sequence of the step.

integer | null format: int32
input_tokens

Prompt tokens of a model call.

integer | null format: int32
kind
required

model, answer, tool, approval, agent or send.

string
model

Model that served the call, for model steps.

string | null
name

Tool name, or model for model calls.

string | null
narration

What the model said alongside this call (model calls and answers).

string | null
offset_ms
required

Start relative to the turn’s start.

integer format: int64
output_tokens

Completion tokens of a model call.

integer | null format: int32
requested_tool_call_ids

Tool calls this model call asked for.

Array<string>
result

Short result or error.

string | null
start_sequence
required

First event sequence of the step.

integer format: int32
started_at
required

When the step started.

string format: date-time
status
required

running, success, error or cancelled.

string
step
required

Per-turn step number, 1-based.

integer format: int32
target

What the call acted on, from the tool’s narration.

string | null
tool_call_id

Tool call identifier, for tool steps.

string | null
turn
required

Turn the step belongs to.

integer format: int32
Example
{
  "events": [
    {
      "id": "event_01a124cd8a1b7f02a5c4e6d1b2f3a4c5",
      "sequence": 14,
      "size_bytes": 512,
      "type": "tool.started"
    }
  ],
  "input": {
    "size_bytes": 221,
    "truncated": false
  },
  "output": {
    "size_bytes": 221,
    "truncated": false
  },
  "request": {
    "message_count": 14,
    "new_from": 12,
    "new_messages": [
      {
        "index": 12,
        "role": "tool",
        "size_bytes": 244
      }
    ],
    "tool_count": 9
  },
  "step": {
    "duration_ms": 269,
    "end_sequence": 21,
    "kind": "tool",
    "model": "gpt-6.1-sol",
    "name": "bash",
    "offset_ms": 3010,
    "start_sequence": 14,
    "status": "success",
    "step": 2,
    "tool_call_id": "call_PzDcvnFaUll8os3tPhWj",
    "turn": 1240
  }
}