Batch Get Conversation Events

Get a batch of local events given their ids, returning null for any missing item.

GET /api/conversations/{conversation_id}/events

Batch Get Conversation Events

cURL

curl --request GET \
  --url https://api.example.com/api/conversations/{conversation_id}/events \
  --header 'Content-Type: application/json' \
  --header 'X-Session-API-Key: <api-key>' \
  --data '[
  "<string>"
]'

200

[
  {
    "tool_call_id": "<string>",
    "title": "<string>",
    "kind": "<string>",
    "id": "<string>",
    "timestamp": "<string>",
    "source": "agent",
    "status": "<string>",
    "tool_kind": "<string>",
    "raw_input": null,
    "raw_output": null,
    "is_error": false
  }
]

Authorizations

X-Session-API-Key · string · header · required

Path Parameters

conversation_id · string<uuid> · required

Body

application/json

Response

200

application/json

(ACPToolCallEvent · object | Condensation · object | CondensationRequest · object | CondensationSummaryEvent · object | ConversationErrorEvent · object | ConversationStateUpdateEvent · object | HookExecutionEvent · object | LLMCompletionLogEvent · object | ActionEvent · object | MessageEvent · object | AgentErrorEvent · object | ObservationEvent · object | UserRejectObservation · object | SystemPromptEvent · object | TokenEvent · object | PauseEvent · object | null)[]

Successful Response

ACPToolCallEvent

Condensation

CondensationRequest

CondensationSummaryEvent

ConversationErrorEvent

ConversationStateUpdateEvent

HookExecutionEvent

LLMCompletionLogEvent

ActionEvent

MessageEvent

AgentErrorEvent

ObservationEvent

UserRejectObservation

SystemPromptEvent

TokenEvent

PauseEvent

Event representing a tool call executed by an ACP server.

Captures the tool name, inputs, outputs, and status from ACP ToolCallStart / ToolCallProgress notifications so they can be surfaced in the OpenHands event stream and visualizer.

This is not an LLMConvertibleEvent — ACP tool calls do not participate in LLM message conversion.

tool_call_id · string · required

title · string · required

kind · string · required

Allowed value: "ACPToolCallEvent"

id · string

Unique event id (ULID/UUID)

timestamp · string

Event timestamp

source · enum<string> · default: agent

Available options: agent, user, environment, hook

status · string | null

tool_kind · string | null

raw_input · unknown

raw_output · unknown

is_error · boolean · default: false