Stream Agent Events

curl -N -X POST https://agent.example.com/v1/agents/sessions/sess_01J5X8/events/stream \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "role": "user",
    "content": "Explain quantum computing"
  }'

event: delta
data: {"content":"Quantum"}

event: delta
data: {"content":" computing"}

event: delta
data: {"content":" is..."}

event: turn.completed
data: {}

curl -N -X POST https://agent.example.com/v1/agents/sessions/sess_01J5X8/events/stream \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "role": "user",
    "content": "Explain quantum computing"
  }'

event: delta
data: {"content":"Quantum"}

event: delta
data: {"content":" computing"}

event: delta
data: {"content":" is..."}

event: turn.completed
data: {}

This endpoint accepts the same payload as the non-streaming create event endpoint but returns a text/event-stream response. You receive delta tokens, turn boundaries, and completion signals as individual SSE events.

Endpoint

POST /v1/agents/sessions/{session_id}/events/stream

Authentication

Pass one of Authorization: Bearer <api-key> or Authorization: ApiKey <key>.

Path Parameters

string

required

The agent session identifier.

Request Body

string

required

The event role. Use user for messages or tool for tool results.

string

Text content of the message. Required when role is user.

array

Array of tool call objects emitted by the model.

array

Array of tool call result objects returned to the model.

Response

The response is text/event-stream. Each line is an SSE event. Common event types include delta for content fragments and turn.completed when a model turn finishes.

curl -N -X POST https://agent.example.com/v1/agents/sessions/sess_01J5X8/events/stream \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "role": "user",
    "content": "Explain quantum computing"
  }'

event: delta
data: {"content":"Quantum"}

event: delta
data: {"content":" computing"}

event: delta
data: {"content":" is..."}

event: turn.completed
data: {}

PIN API

ROUTER API

AGENT API

Endpoint

Authentication

Path Parameters

Request Body

Response

​Endpoint

​Authentication

​Path Parameters

​Request Body

​Response

Endpoint

Authentication

Path Parameters

Request Body

Response