Skip to main content
GET
/
api
/
v1
/
conversation
/
{conversation_id}
/
events
Batch Get Events
curl --request GET \
  --url https://app.all-hands.dev/api/v1/conversation/{conversation_id}/events \
  --header 'X-Access-Token: <api-key>'
[
  {
    "source": "agent",
    "code": "<string>",
    "detail": "<string>",
    "kind": "<string>",
    "id": "<string>",
    "timestamp": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://allhandsai-add-v1-api-reference.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Access-Token
string
header
required

Path Parameters

​
conversation_id
string
required

Query Parameters

​
id
string[]
required

Response

(ServerErrorEvent · object | 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

Event emitted by the agent server when a server-level error occurs.

This event is used for errors that originate from the agent server itself, such as MCP connection failures, WebSocket errors, or other infrastructure issues. Unlike ConversationErrorEvent which is for conversation-level failures, this event indicates a problem with the server environment.

​
source
enum<string>
required

The source of this event

Available options:
agent,
user,
environment,
hook
​
code
string
required

Code for the error - typically an error type

​
detail
string
required

Details about the error

​
kind
string
required
Allowed value: "ServerErrorEvent"
​
id
string

Unique event id (ULID/UUID)

​
timestamp
string

Event timestamp