Skip to content

Delete a message

delete
https://api.reach.talkylabs.com/rest/messaging/v1/delete

This operation allows to delete a message record from the applet account. Once the record is deleted, it will no longer appear in the Reach platform.

This operation needs the messageId of the message to be deleted. To delete multiple messages, this operation should be called as many times as needed since it can only delete one message at a time.

Note: Attempting to delete an in-progress message record, i.e. a message whose status is not delivered, failed, canceled, or undelivered, will result in an error.

Parameters

  • messageIdstringrequired

    The identifier of the message to be deleted.

Note on message deletion

Once deleted, message can not be recovered.

Example 1: Delete a message

curl -X POST https://api.reach.talkylabs.com/rest/messaging/v1/delete --data-urlencode "messageId=MIDXXXXXXXXXXXXXX" -H "ApiUser: $REACH_TALKYLABS_API_USER" -H "ApiKey: $REACH_TALKYLABS_API_KEY"
Output example