Public API

Delete a message for everyone, or cancel it while queued

A queued message is canceled and fails with error_code canceled; a sent one is deleted for everyone within 48 hours of sending.

delete/v1/messages/{messageId}

Request

  • Base URL: https://otprun.com
  • URL: https://otprun.com/v1/messages/{messageId}
  • Auth: HTTP bearer

Path parameters

messageIdstring uuid required

Response

OK

attemptsinteger required
bodystring required
channel'whatsapp_gateway' | 'telegram' | 'telegram_gateway' | 'whatsapp_official' required
contact_namestring required

Name of the recipient in the address book, empty if not saved

created_atstring date-time required
delivered_atstring date-time nullable required
edited_atstring date-time nullable required

When the text was last edited after sending, null if never

error_codestring required
error_detailstring required

The error WhatsApp returned on the last failed attempt, empty when there was none

failed_atstring date-time nullable required
idstring uuid required
outcome'delivered' | 'on_the_way' | 'retrying' | 'unconfirmed' | 'undecrypted' | 'not_delivered' required

What happened to the message in plain terms: unconfirmed means WhatsApp accepted it but the phone has not confirmed it for 10 minutes

project_idinteger required
purpose'notification' | 'otp' required
read_atstring date-time nullable required
revoked_atstring date-time nullable required

When the message was deleted for everyone, null if not

scheduled_atstring date-time required

Earliest moment the gateway sends the message

sent_atstring date-time nullable required
slot_idstring nullable required
status'queued' | 'sending' | 'sent' | 'delivered' | 'read' | 'failed' required
to_phonestring required

Changes

No recorded changes to this operation across all 1 revision of this API.