> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ResponseField name="event" type="string" required>
  The event type: `action_log.failed`
</ResponseField>

<ResponseField name="actionLog" type="object">
  The failed action log object

  <Expandable title="actionLog">
    <ResponseField name="id" type="string" required>
      Unique identifier for the action log
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Type of action that failed: `SYSTEM_NOTE`, `MESSAGE`, `FOLLOW_UP_MESSAGE`, `TOOL_CALL`, `DOCUMENT_UPLOAD`, `MANUAL_UPDATE`
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Status of the action: `FAILED`
    </ResponseField>

    <ResponseField name="summary" type="string">
      Brief summary of the failed action
    </ResponseField>

    <ResponseField name="input" type="object">
      Input data for the action
    </ResponseField>

    <ResponseField name="output" type="object" nullable>
      Output data from the action (usually null for failed actions)
    </ResponseField>

    <ResponseField name="error" type="string">
      Error message describing why the action failed
    </ResponseField>

    <ResponseField name="leadId" type="string" required>
      ID of the lead associated with this action
    </ResponseField>

    <ResponseField name="agentId" type="string" required>
      ID of the agent that attempted the action
    </ResponseField>

    <ResponseField name="tool" type="object" nullable>
      Tool information if this was a tool call failure
    </ResponseField>

    <ResponseField name="completedAt" type="string" required>
      ISO 8601 timestamp when the action failed
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="workspaceId" type="string" required>
  ID of the workspace this event belongs to
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "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": []
    }
  }
  ```
</ResponseExample>