Retry a failed message

Attempt to re-deliver a message that previously failed to send. Only messages with a failed status can be retried. Messages that have permanently failed (a failed status with an error code) and messages with an undelivered status cannot be retried.

POST /messages/{messageId}/retry

Retry a failed message

cURL

curl --request POST \
  --url https://dev-public-api.openphone.dev/messages/{messageId}/retry \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'

202

{}

{
  "message": "The input was invalid",
  "docs": "https://quo.com/docs",
  "title": "Bad Request",
  "errors": [
    {
      "path": "/messageId",
      "message": "Expected string to match '^AC(.*)$'",
      "value": "abc123",
      "schema": {
        "type": "TemplateLiteral",
        "pattern": "^AC(.*)$"
      }
    }
  ]
}

{
  "message": "Unauthorized",
  "docs": "https://quo.com/docs",
  "title": "Unauthorized",
  "trace": "6897907457496870895"
}

{
  "message": "The user is forbidden from accessing the message",
  "docs": "https://quo.com/docs",
  "title": "Forbidden",
  "trace": "6897907457496870895"
}

{
  "message": "Message not found",
  "docs": "https://quo.com/docs",
  "title": "Not Found",
  "trace": "6897907457496870895"
}

{
  "message": "The message has permanently failed and cannot be retried",
  "docs": "https://quo.com/docs",
  "title": "Unprocessable Entity",
  "trace": "6897907457496870895"
}

{
  "message": "We have encountered an unknown error",
  "docs": "https://quo.com/docs",
  "title": "Unknown",
  "trace": "6897907457496870895"
}

Authorizations

Authorization · string · header · required

Headers

Quo-Api-Version · enum<string> · required

API version header. Supported values: 2026-03-30

Available options: 2026-03-30

Path Parameters

messageId · string · required

The unique identifier of the message to retry

Pattern: ^AC(.*)$

Example:

"AC123abc"

Response

202

application/json

Accepted

The response is of type object.