On Event

Webhook callback for when event stream events occur.

POST /api/v1/webhooks/events/{conversation_id}

On Event

cURL

curl --request POST \
  --url https://app.all-hands.dev/api/v1/webhooks/events/{conversation_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Token: <api-key>' \
  --data '
[
  {
    "source": "agent",
    "code": "<string>",
    "detail": "<string>",
    "id": "<string>",
    "timestamp": "<string>",
    "kind": "<string>"
  }
]
'

200

{
  "success": true
}

Authorizations

X-Access-Token · string · header · required

Path Parameters

conversation_id · string<uuid> · required

Body

application/json

ServerErrorEvent

ACPToolCallEvent

Condensation

CondensationRequest

CondensationSummaryEvent

ConversationErrorEvent

ConversationStateUpdateEvent

HookExecutionEvent

LLMCompletionLogEvent

ActionEvent

MessageEvent

AgentErrorEvent

ObservationEvent

UserRejectObservation

SystemPromptEvent

TokenEvent

PauseEvent

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

id · string

Unique event id (ULID/UUID)

timestamp · string

Event timestamp

kind · string

Allowed value: "ServerErrorEvent"

Response

200

application/json

Successful Response

success · boolean · default: true