Session Event

Read and write session event information

Session Event object

Attributes

object

String

id

String

The unique identifier for the session event

type

Enum

The type of session event

session_id

String

The ID of the related session

server_run

ObjectNullable

server_run_error

ObjectNullable

log_lines

Object

Array of log lines associated with the event

created_at

Date

Timestamp when the event was created

{
  "object": "session.event",
  "type": "server_logs",
  "server_run": {
    "object": "server.server_run",
    "type": "hosted",
    "status": "active",
    "server": {
      "object": "server#preview",
      "type": "public"
    },
    "server_deployment": {
      "object": "server.server_deployment#preview",
      "metadata": {},
      "server": {
        "object": "server#preview",
        "type": "public"
      }
    },
    "server_session": {
      "object": "session.server_session#preview",
      "status": "active",
      "mcp": {
        "object": "mcp",
        "connection_type": "sse",
        "client": {
          "object": "session.server_session.client",
          "capabilities": {}
        },
        "server": {
          "object": "session.server_session.server",
          "capabilities": {}
        }
      },
      "usage": {}
    }
  },
  "server_run_error": {
    "object": "server.server_run.error",
    "metadata": {},
    "server_run": {
      "object": "server.server_run",
      "type": "hosted",
      "status": "active",
      "server": {
        "object": "server#preview",
        "type": "public"
      },
      "server_deployment": {
        "object": "server.server_deployment#preview",
        "metadata": {},
        "server": {
          "object": "server#preview",
          "type": "public"
        }
      },
      "server_session": {
        "object": "session.server_session#preview",
        "status": "active",
        "mcp": {
          "object": "mcp",
          "connection_type": "sse",
          "client": {
            "object": "session.server_session.client",
            "capabilities": {}
          },
          "server": {
            "object": "session.server_session.server",
            "capabilities": {}
          }
        },
        "usage": {}
      }
    }
  },
  "log_lines": [
    {
      "type": "stdout"
    },
    {
      "type": "stdout"
    }
  ]
}

List session events

List all events for a specific session

URL Parameters

session_id

String

The unique identifier for the session

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

server_run_id

UnionOptional

server_session_id

UnionOptional
GEThttp://api.metorial.com/sessions/:session_id/events
curl -X GET "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY/events" \
  -H "Authorization: Bearer metorial_sk_..."

Get session event

Get details of a specific session event

URL Parameters

session_id

String

The unique identifier for the session

session_event_id

String

The unique identifier for the session_event

GEThttp://api.metorial.com/sessions/:session_id/events/:session_event_id
curl -X GET "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY/events/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."