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