Mark Failed
Mobile App Integration Guide
Mark Failed
Reports that a message could not be sent. Increments the campaign failed_count and the queue retry_count.
Request Body
| Field | Type | Description | |
|---|---|---|---|
| id | integer | required | Queue message ID. |
| reason | string | optional | Human-readable failure reason (max 499 chars). Stored in failed_reason. |
Example Request
cURL
curl -X POST "https://api.rcszilla.com/?endpoint=mark_failed" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR-DEVICE-TOKEN" \
-d '{"id": 101, "reason": "SmsManager returned RESULT_ERROR_NO_SERVICE"}'
Response
JSON200 OK
{"success": true, "message": "Marked as failed"}
Each call increments
retry_count on the queue row. The web panel's retry cron will re-queue the message automatically based on the configured retry policy.