React to a message

POST/v1/messages/{message_id}/reactions

React to a message with an emoji, or remove the reaction with an empty one.

Scope messages:writeIdempotency-Key required

Path parameters

message_idstring, uuidRequired

Request body

One emoji on a message, in the same conversation. An empty emoji takes the reaction back.

emojistringRequired
Up to 32 characters

Response

  • 202Success
Response fields
message_idstringRequired
conversation_idstringRequired
seqintegerRequired
directionstringRequired
sourcestringRequired
authorobjectRequired
May be null
typestringRequired
contentobjectRequired
reply_to_message_idstringRequired
May be null
attachmentsarray of object
Default
attachments[].idstringRequired
attachments[].kindstringRequired
attachments[].mime_typestringRequired
May be null
attachments[].file_namestringRequired
May be null
attachments[].size_bytesintegerRequired
May be null
statusstringRequired
read_inferredbooleanRequired
provider_message_idstringRequired
May be null
errorobjectRequired
May be null
error.codestringRequired
error.messagestringRequired
error.provider_codeintegerRequired
May be null
error.detailsobjectRequired
May be null
created_atstring, date-timeRequired
queued_atstring, date-timeRequired
May be null
submitted_atstring, date-timeRequired
May be null
sent_atstring, date-timeRequired
May be null
delivered_atstring, date-timeRequired
May be null
read_atstring, date-timeRequired
May be null
rejected_atstring, date-timeRequired
May be null
failed_atstring, date-timeRequired
May be null

Errors

  • 400idempotency_key_required
  • 401unauthorized. The key is missing, unknown or revoked
  • 403insufficient_scope. The key lacks the scope above
  • 404not_found. no such message
  • 409channel_disconnected, idempotency_conflict
  • 422validation_error, a bad emoji, or the message is not sent yet, window_closed, contact_blocked

Every error has the same shape. See Errors.