mark_agent_message_failed
Report processing failures in agent messages by recording error details and updating status to failed. Use when an agent cannot complete message processing.
Instructions
Mark a message processing as failed by the agent.
Completes the current processing attempt with an error message.
Call this when the agent cannot process a message.
This endpoint automatically:
- Sets the current attempt's completed_at timestamp (system-managed)
- Sets the current attempt status to "failed"
- Records the error message in the current attempt
- Updates the agent's delivery status to "failed"
Note: Requires an active processing attempt. If no processing attempt exists,
returns a 422 error. Call mark_agent_message_processing first.
Args:
chat_id: The unique identifier of the chat room (required).
message_id: The ID of the message to mark as failed (required).
error: Error message describing why processing failed (required).
Returns:
Success message confirming the message is marked as failed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat_id | Yes | ||
| message_id | Yes | ||
| error | Yes |