~/docs/webhooks / events / message.error
message.error
Fired when an AI message fails during generation.
This event is triggered if the orchestrator AI encounters an unrecoverable error during execution, such as hitting token limits, API failures, or tool execution crashes.
Payload
json
{
"event": "message.error",
"timestamp": "2026-06-13T17:37:52.204Z",
"data": {
"id": "msg_123abc",
"chatId": "5620d1c6-b394-405c-9608-6ade631f98f2",
"role": "assistant",
"status": "error",
"content": "An unexpected error occurred during execution.",
"reasoning": null,
"toolCalls": [],
"toolResults": [],
"attachments": [],
"createdAt": "2026-06-13T17:37:50.539Z",
"updatedAt": "2026-06-13T17:37:52.204Z"
}
}