Get Conversation Event

Get a local event given an id

GET /api/conversations/{conversation_id}/events/{event_id}

Get Conversation Event

cURL

curl --request GET \
  --url https://api.example.com/api/conversations/{conversation_id}/events/{event_id}

200

{
  "llm_response_id": "<string>",
  "kind": "<string>",
  "id": "<string>",
  "timestamp": "<string>",
  "source": "environment",
  "forgotten_event_ids": [
    "<string>"
  ],
  "summary": "<string>",
  "summary_offset": 1
}

Path Parameters

event_id · string · required

conversation_id · string<uuid> · required

Response

200

application/json

Successful Response

Condensation

CondensationRequest

CondensationSummaryEvent

ConversationErrorEvent

ConversationStateUpdateEvent

LLMCompletionLogEvent

ActionEvent

MessageEvent

AgentErrorEvent

ObservationEvent

UserRejectObservation

SystemPromptEvent

TokenEvent

PauseEvent

This action indicates a condensation of the conversation history is happening.

llm_response_id · string · required

Completion or Response ID of the LLM response that generated this event

kind · string · required

Allowed value: "Condensation"

id · string

Unique event id (ULID/UUID)

timestamp · string

Event timestamp

source · enum<string> · default: environment

Available options: agent, user, environment

forgotten_event_ids · string[]

The IDs of the events that are being forgotten (removed from the View given to the LLM).

summary · string | null

An optional summary of the events being forgotten.

summary_offset · integer | null

An optional offset to the start of the resulting view (after forgotten events have been removed) indicating where the summary should be inserted. If not provided, the summary will not be inserted into the view.

Required range: x >= 0