API Documentation
Failed Actions Tracking and Retry System
5 min
the failed actions tracking system provides visibility and control over actions that fail during content moderation when applying actions to flagged content, webhook delivery may occasionally fail due to endpoint unavailability or other issues this feature helps you identify, track, and resolve these failures visual indicators failed actions are visually identified in the flag list through color coding orange indicates that automated retry attempts are in progress but have not reached the maximum number of attempts (9 retries) red indicates that all automated retry attempts (9 retries) have been exhausted without success filtering failed reports a dedicated filter option allows you to quickly identify all failed actions in the flag or appeal list, use the filter dropdown to select "failed reports/appeals" this will display only items with failed webhook actions (both orange and red indicators) viewing failed action details when you open a flag or appeal marked with orange or red, you can view detailed information about the failed action in the right bottom side through the "action failures details" button, which opens a drawer containing all the failure information action id unique identifier for the action response code the http status code received from the endpoint response body the complete response returned from the endpoint attempts number of retry attempts executed so far last execution date timestamp of the most recent retry attempt automated retry mechanism nima automatically attempts to deliver webhook up to 9 times when an initial action fails the retry process follows these steps initial action attempt fails flag is marked orange in the list nima automatically retries the webhook delivery (up to 9 times) if successful at any point, the flag status becomes processed if all 9 retries fail, the flag is marked red in the list manual retry functionality becomes available manual retry functionality for flags marked in red, you have the option to manually retry the action open the flag details modal review the failure information click the "retry action" button nima will trigger the same workflow as the automated process including up to 9 retry attempts if the initial delivery fails if successful, the flag status will be updated accordingly, otherwise it will fall back to red highlight this failed actions tracking and retry system is fully implemented for both appeals and flags the same goes for visual indicators, filtering options, detailed information display, and retry mechanisms