Skip to content
Console
On this page

Session events

A SessionEvent is one entry of a session's append-only log: a user message, model output, a tool call or result, an approval, or a status…

A SessionEvent is one entry of a session's append-only log: a user message, model output, a tool call or result, an approval, or a status change. Events are never changed or reordered; sequence is their order.

Service Sylphx Agents · Resource type agents.sylphx.com/SessionEvent · Name pattern orgs/{org}/projects/{project}/envs/{env}/agent_sessions/{agent_session}/session_events/{session_event} · Shape record

Fields

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/agent_sessions/{agent_session}/session_events/{session_event}.
uidstringsevt_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
sequenceint64The position in the session's log, from 1, with no gaps. Output only.
typeSessionEventTypeWhat the event is. Output only. One of user_message, steer, agent_message, tool_call, tool_result, approval_requested, approval_decided, status, compaction, thought, file_change, response, error, usage, sandbox, wait_changed, wait_continuation.
turnint64The turn it belongs to, from 1; 0 for an event outside a turn. Output only.
stepint64The step within the turn, from 1, assigned by the runtime; 0 for an event that is not a step. Output only.
create_timetimestampWhen it was appended. Output only.
usageStepUsageObserved accounting for this step; absent values are unknown, never zero. Output only.
step_keystringStable runtime-assigned effect key, independent of invocation attempts. Output only.
messageMessageFor USER_MESSAGE, STEER and AGENT_MESSAGE. One of the payload group.
tool_callToolCallFor TOOL_CALL. One of the payload group.
tool_resultToolResultFor TOOL_RESULT. One of the payload group.
approvalApprovalFor APPROVAL_REQUESTED and APPROVAL_DECIDED. One of the payload group.
status_changeStatusChangeFor STATUS. One of the payload group.
thoughtMessageFor THOUGHT: a reasoning summary, never private model reasoning. One of the payload group.
file_changeFileChangeFor FILE_CHANGE. One of the payload group.
responseTurnResultFor RESPONSE: the completed turn's answer and usage. One of the payload group.
errorErrorEventFor ERROR. One of the payload group.
sandboxSandboxActivityFor SANDBOX: authoritative allocation/release history, including replacements. One of the payload group.
waitAgentSessionWaitFor WAIT_CHANGED: a durable wait fact, without execution authority. One of the payload group.
wait_continuationSessionWaitContinuationFor WAIT_CONTINUATION: ready owners consumed by exact turn admission. One of the payload group.

Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETgetGets a session event.
GETlistLists a session's events in sequence order. To follow a session, call again with the filter sequence > N, N the last sequence read; wait holds the call open until a newer event is appended or the wait ends.

get

Gets a session event.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/session_events/session-event · scope agents:sessions · effect read · Request, response and examples

list

Lists a session's events in sequence order. To follow a session, call again with the filter sequence > N, N the last sequence read; wait holds the call open until a newer event is appended or the wait ends.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/session_events · scope agents:sessions · effect read · paginated · Request, response and examples