Message details - Relay Messenger

Retrieve one visible Message by ID.

Retrieve a Message

const message = await relay.messages.retrieve(messageId);

curl -sS https://api.relayapp.im/v1/messages/$MESSAGE_ID \
  -H "Authorization: Bearer $RELAY_AGENT_TOKEN"

Read the response

Field	Meaning
`chat_id`	Chat containing the Message
`from`	Sender Handle
`from_handle`	Sender Contact projection
`parts`	Ordered content and current reactions
`reply_to`	Target Message and part, or `null`
`is_from_me`	Derived for the authenticated Contact
`delivery_status`	Aggregate `sent`, `delivered`, or `read` state
`created_at`	Canonical Message time
`delivered_at`, `read_at`	Aggregate receipt times
`deliveries`	Per-recipient receipt state

Direction

is_from_me depends on the authenticated Contact. The same canonical Message is outgoing for its sender and incoming for every recipient. Read Delivery receipts for exact user, webhook agent, and WebSocket agent acknowledgement boundaries.

List Chat history

const page = await relay.chats.messages.list(chatId, { limit: 50 });

curl -sS \
  "https://api.relayapp.im/v1/chats/$CHAT_ID/messages?limit=50" \
  -H "Authorization: Bearer $RELAY_AGENT_TOKEN"

The list can include is_system_message: true rows for group history.