Skip to main content
POST
On Event

Authorizations

X-Access-Token
string
header
required

Path Parameters

conversation_id
string<uuid>
required

Body

application/json

Event emitted by the agent server when a server-level error occurs.

This event is used for errors that originate from the agent server itself, such as MCP connection failures, WebSocket errors, or other infrastructure issues. Unlike ConversationErrorEvent which is for conversation-level failures, this event indicates a problem with the server environment.

source
enum<string>
required

The source of this event

Available options:
agent,
user,
environment,
hook
code
string
required

Code for the error - typically an error type

detail
string
required

Details about the error

id
string

Unique event id (ULID/UUID)

timestamp
string

Event timestamp

parent_id
string | null

Parent event id in the conversation tree. None for the root, or for legacy events predating the tree (see EventLog's effective-parent rule). Events sharing a parent_id are sibling branches.

kind
string
Allowed value: "ServerErrorEvent"

Response

Successful Response

success
boolean
default:true