action_log.failed

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

event · string · required

The event type: action_log.failed

actionLog · object

The failed action log object

Show actionLog

id · string · required

Unique identifier for the action log

type · string · required

Type of action that failed: SYSTEM_NOTE, MESSAGE, FOLLOW_UP_MESSAGE, TOOL_CALL, DOCUMENT_UPLOAD, MANUAL_UPDATE

status · string · required

Status of the action: FAILED

summary · string

Brief summary of the failed action

input · object

Input data for the action

output · object

Output data from the action (usually null for failed actions)

error · string

Error message describing why the action failed

leadId · string · required

ID of the lead associated with this action

agentId · string · required

ID of the agent that attempted the action

tool · object

Tool information if this was a tool call failure

completedAt · string · required

ISO 8601 timestamp when the action failed

workspaceId · string · required

ID of the workspace this event belongs to

{
  "event": "action_log.failed",
  "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": []
  }
}