Skip to main content
DELETE
Remove a reaction
  • Credential: an API key. A trial key returns 401 unauthorized. See Removing a reaction.
  • Line-scoped keys: a line-scoped key gets 404 not_found for a message on a line outside its list.
  • Test keys: a removal sent with an isnap_test_ account key reaches the real contact: see Test keys.
  • Idempotency-Key: honored. The key shares the space of the line with POST /v1/messages. See Retrying a reaction.
  • Events: sends reaction.removed when the line’s device confirms the removal. Sends nothing in the other cases.
  • Response: removed is false and type is null when the line had no reaction on the message. removed: true does not mean that the reaction left the contact’s screen: when the line has no paired device, or when the device fails the removal, nothing reaches the contact.

Errors

The errors that every operation shares are in Errors.

Authorizations

Authorization
string
header
required

An API key created in the iSnap dashboard, or a trial key, sent as Authorization: Bearer <key>. An API key starts with isnap_live_ or isnap_test_; both act on the same account, lines and billing. A trial key acts on its trial only.

Path Parameters

id
string
required

Message id: msg_ followed by 25 letters or digits.

Pattern: ^msg_[0-9A-Za-z]{25}$

Response

The result. removed is false when the line had no reaction on the message.

success
enum<boolean>
required

Always true on a success response.

Available options:
true
data
object
required

The result of DELETE /v1/messages/{id}/reactions.

trace_id
string
required

Trace id of the request that produced this response: 32 lowercase hexadecimal characters. Quote it when you report a problem to iSnap.

request_id
string
required

Id of the request that produced this response: req_ followed by 25 letters or digits.