Reference

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…

Checked 2026-09-28

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

Not available yet. Sylphx Agents is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.

#Fields

Field	Type	What it is
name	string	orgs/{org}/projects/{project}/envs/{env}/agent_sessions/{agent_session}/session_events/{session_event}.
uid	string	sevt_<cell><ulid>; never reused. Output only.
meta	ResourceMeta	Resource metadata.
sequence	int64	The position in the session's log, from 1, with no gaps. Output only.
type	SessionEventType	What 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.
turn	int64	The turn it belongs to, from 1; 0 for an event outside a turn. Output only.
step	int64	The step within the turn, from 1, assigned by the runtime; 0 for an event that is not a step. Output only.
create_time	timestamp	When it was appended. Output only.
message	Message	For USER_MESSAGE, STEER and AGENT_MESSAGE. One of the payload group.
tool_call	ToolCall	For TOOL_CALL. One of the payload group.
tool_result	ToolResult	For TOOL_RESULT. One of the payload group.
approval	Approval	For APPROVAL_REQUESTED and APPROVAL_DECIDED. One of the payload group.
status_change	StatusChange	For STATUS. One of the payload group.
thought	Message	For THOUGHT: a reasoning summary, never private model reasoning. One of the payload group.
file_change	FileChange	For FILE_CHANGE. One of the payload group.
response	TurnResult	For RESPONSE: the completed turn's answer and usage. One of the payload group.
error	ErrorEvent	For ERROR. 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.

Method	Call	What it does
GET	get	Gets a session event.
GET	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

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 · not available yet · 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 · not available yet · paginated · Request, response and examples