Optimly MCP
Record Action Failed
Record that an external execution action failed. BrandVault completion is recorded by brand_update or brand_publish and does not require this tool.
record_action_failed · Approval required · Authentication required
Record that an external execution action failed. BrandVault completion is recorded by brand_update or brand_publish and does not require this tool.
When to use
Use when an externally executed action failed, with an error code and message when available.
Access
Approved access with action-management permission
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action_id | uuid | Yes | Execution action that failed. |
actor | { type, id } | Yes | Actor identity; type is human, agent, or system. |
error_code | string | No | Machine-readable failure code. |
error_message | string | No | Human-readable failure description. |
approval_id | uuid | No | Approval bound to this execution, when required. |
external_reference | string | No | External system reference. |
external_url | string | No | External URL related to the failure. |
brand_id | uuid | No | Authorized brand ID. Required when more than one brand is available. |
Example prompt
Record that the CMS publish failed with a permissions error.
Side effects and safety
Appends a failed event to the action's status history.