> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monumint.com/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

**event** `string` *required*

The event type: `action_log.failed`

**actionLog** `object`

The failed action log object

**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

**workflowRunId** `string | null`

ID of the workflow run this action was taken under, or `null` when it did not happen under a workflow run

**externalWorkflowRunId** `string | null`

Your own identifier for that workflow run, if you set one when creating it

**tool** `object`

Tool information if this was a tool call failure

**completedAt** `string` *required*

ISO 8601 timestamp when the action failed

**actor** `object | null`

Workspace user who triggered this action. Returns `null` for actions not
initiated by a workspace user.

**actor**

**type** `enum`

Type of actor

**id** `string`

Unique identifier for the user

**name** `string | null`

Name of the user

**email** `string`

Email address of the user

**workspaceId** `string` *required*

ID of the workspace this event belongs to

```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",
    "workflowRunId": "5d8c1f3a-7b2e-4c9d-8e1f-2a3b4c5d6e7f",
    "externalWorkflowRunId": "crm-run-8813",
    "tool": {
      "id": "tool_123",
      "name": "deep_research"
    },
    "messages": []
  },
  "actor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.