Create Agent Event

curl -X POST https://agent.example.com/v1/agents/sessions/sess_01J5X8/events \ -H "Authorization: Bearer <api-key>" \ -H "Content-Type: application/json" \ -d '{ "role": "user", "content": "What is the weather in Tokyo?" }'

Use this endpoint to push an event into an active agent session. The body accepts a user message, tool calls, or tool results, and the API returns the created event with its generated identifier.

Endpoint

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

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

string

Unique event identifier.

string

The session this event belongs to.

string

Event type, for example message.

string

ISO 8601 timestamp of creation.

curl -X POST https://agent.example.com/v1/agents/sessions/sess_01J5X8/events \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "user",
    "content": "What is the weather in Tokyo?"
  }'

{
  "id": "evt_01J5X9",
  "session_id": "sess_01J5X8",
  "type": "message",
  "created_at": "2024-06-01T12:34:56Z"
}

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