Update external message status

Update the status of an outbound message by external ID. This endpoint is used by external systems (like SMS providers or custom channels) to notify Front when a message's delivery status has changed.

Available status changes:

  • failed: Mark a message as failed. When marked as failed, the conversation is reopened so the team can take action.

Note: This endpoint is only available for outbound messages.

Path Params
string
required
Defaults to cha_123

The channel ID. Alternatively, you can supply the channel address as a resource alias.

string
required

The conversation's external ID.

string
required

The message's external ID.

Body Params
string
enum
required

The status to set for the message. Currently only 'failed' is supported.

Allowed:
string

Optional reason for the status change. This will be displayed to users and logged for debugging purposes.

Response
204

No content

Language
Credentials
Bearer
JWT