API referenceMessages

Retry

POST/v1/messages/{message_id}/retry

Send a failed or rejected outbound message again, as a new message with the same content and file.

The failed one stays in the conversation; each can be sent again once.

Scope: messages:write
Idempotency: Optional key

Path parameters

message_idstring, uuidRequired

Response

202Success

Response fields 33

message_idstringRequired
conversation_idstringRequired
seqintegerRequired
directionstringRequired
sourcestringRequired
authorobjectRequired: May be null
typestringRequired
contentobjectRequired
reply_to_message_idstringRequired: May be null
attachmentsarray of object: Default
attachments[].idstring
attachments[].sourceenum: One of omnio, link
attachments[].kindstring
attachments[].mime_typestring: May be null
attachments[].file_namestring: May be null
attachments[].size_bytesinteger: May be null
statusstringRequired
read_inferredbooleanRequired
provider_message_idstringRequired: May be null
errorobjectRequired: May be null
error.codestringRequired
error.messagestringRequired
error.provider_codeintegerRequired: May be null
error.detailsobjectRequired: May be null
created_atstring, date-timeRequired
queued_atstring, date-timeRequired: May be null
submitted_atstring, date-timeRequired: May be null
sent_atstring, date-timeRequired: May be null
delivered_atstring, date-timeRequired: May be null
read_atstring, date-timeRequired: May be null
rejected_atstring, date-timeRequired: May be null
failed_atstring, date-timeRequired: May be null
retry_of_message_idstring: May be null

Errors

401unauthorized. The key is missing, unknown or revoked
403insufficient_scope. The key lacks the scope above
404not_found. no such message
409conflict, details.reason is not_failed or already_retried, channel_disconnected, idempotency_conflict
422window_closed, contact_blocked

Every error has the same shape. See Errors.

POST /v1/messages/{message_id}/retry

curl -X POST https://api.omnio.sawego.com/v1/messages/d4a1f0c2-6e83-4b95-b7d1-9c0e2a5f8b13/retry \
  -H "Authorization: Bearer $OMNIO_API_KEY"
  -H "Idempotency-Key: $(uuidgen)"

202 response

{
  "message_id": "d4a1f0c2-6e83-4b95-b7d1-9c0e2a5f8b13",
  "conversation_id": "2c6e8a14-90b3-4d57-a1f2-3e5b7c9d0f41",
  "seq": 42,
  "direction": "outbound",
  "source": "api",
  "author": {
    "type": "api",
    "api_key_id": "d4a1f0c2-6e83-4b95-b7d1-9c0e2a5f8b13",
    "name": "n8n"
  },
  "type": "text",
  "content": {
    "text": "Your order 4821 ships Thursday."
  },
  "reply_to_message_id": "7d1e4a0c-3b52-4c8e-9f60-2a5b8c1d9e33",
  "attachments": [],
  "status": "open",
  "read_inferred": false,
  "provider_message_id": "wamid.HBgMMjM3NjkwMDAwMDk5FQIAERgSQzA",
  "error": {
    "code": "window_closed",
    "message": "The customer last wrote over 24 hours ago.",
    "provider_code": 1,
    "details": {}
  },
  "created_at": "2026-10-05T14:02:11Z",
  "queued_at": null,
  "submitted_at": null,
  "sent_at": null,
  "delivered_at": null,
  "read_at": null,
  "rejected_at": null,
  "failed_at": null,
  "retry_of_message_id": "b1c7e0a4-52a3-4a3c-8d0e-6c1b9e5f7a20"
}