Examples

curl -X POST "$BASE/messaging/messages/send/$CHAT_SLUG/text" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Hi 👋", "front_id": "tmp-2931" }'

await fetch(`${BASE}/messaging/messages/send/${chatSlug}/text`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${jwt}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ body: 'Hi 👋', front_id: crypto.randomUUID() }),
});

await axios.post(`${BASE}/messaging/messages/send/${chatSlug}/text`,
  { body: 'Hi 👋' },
  { headers: { Authorization: `Bearer ${jwt}` } });

curl -X POST "$BASE/messaging/messages/send/$CHAT_SLUG/image" \
  -H "Authorization: Bearer $JWT" \
  -F "files=@/path/to/photo.jpg" \
  -F "caption=Here you go"

const form = new FormData();
form.append('files', fileInput.files[0]);
form.append('caption', 'Here you go');
await fetch(`${BASE}/messaging/messages/send/${chatSlug}/image`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${jwt}` }, // no Content-Type — the browser sets the boundary
  body: form,
});

curl "$BASE/messaging/messages/$CHAT_SLUG?page=1&limit=25" \
  -H "Authorization: Bearer $JWT"

import { io } from 'socket.io-client';

const socket = io(`${WS_HOST}/messaging/events`, {
  auth: { token: jwt },
  transports: ['websocket'],
});

socket.on('connected', () => console.log('live'));
socket.on('message', (e) => addMessage(e.payload));   // new inbound/outbound message
socket.on('message-ack', (e) => setStatus(e.messageSlug, e.acknowledgment));
socket.on('chat-read', (e) => markRead(e.chatSlug));
socket.on('error', (e) => console.warn('ws error', e));

// let the server know you're viewing a chat
socket.emit('seen', { sessionSlug, chatSlug });

curl -X POST "$BASE/messaging/messages/send/$CHAT_SLUG/text" \
  -H "Authorization: Bearer $JWT" -H "Content-Type: application/json" \
  -d '{ "body": "Sure!", "replyTo": "msg-7f21c" }'