Triggered when an action log fails.
Event Type
action_log.failed
Description
This event is fired whenever an action log fails to complete successfully. Use this event to monitor errors, implement retry logic, or alert your team about failed actions.
Payload Structure
The event type, always “action_log.failed”
The failed action log object Unique identifier for the action log
Type of action that failed (e.g., “TOOL_CALL”, “MESSAGE”)
Status of the action, always “FAILED” for this event
Brief summary of the failed action
Input data for the action
Output data from the action (usually null for failed actions)
Error message describing why the action failed
ID of the lead associated with this action
ID of the agent that attempted the action
Tool information if this was a tool call failure
ISO 8601 timestamp when the action failed
ISO 8601 timestamp when the event occurred
ID of the workspace this event belongs to
{
"event" : "action_log.failed" ,
"occurredAt" : "2025-10-30T21:12:45.123Z" ,
"workspaceId" : "6048d78a-584a-4f1e-9e39-e011ca4cc48c" ,
"actionLog" : {
"id" : "8f2b3f2a-9a3e-4f02-9f0d-1a2b3c4d5e6f" ,
"type" : "TOOL_CALL" ,
"status" : "FAILED" ,
"summary" : "Deep research failed" ,
"input" : {
"toolType" : "deep_research" ,
"query" : "market analysis for ACME"
},
"output" : null ,
"error" : "Upstream provider timeout after 5s" ,
"completedAt" : "2025-10-30T21:12:44.987Z" ,
"leadId" : "4cc8af99-b313-4c1f-b98b-009f38a4721a" ,
"agentId" : "c12d3456-7890-4abc-def1-234567890abc" ,
"tool" : {
"id" : "tool_123" ,
"name" : "deep_research"
},
"messages" : []
}
}