Voice memos - Relay Messenger

Upload audio first, then send it through the dedicated voice memo route.

Upload audio

const allocation = await relay.attachments.create({
  filename: "answer.m4a",
  content_type: "audio/x-m4a",
  size_bytes: bytes.byteLength,
  duration_ms: 12_400,
});

await relay.attachments.upload(allocation, bytes);

curl -sS -X POST https://api.relayapp.im/v1/attachments \
  -H "Authorization: Bearer $RELAY_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename":"answer.m4a",
    "content_type":"audio/x-m4a",
    "size_bytes":183422,
    "duration_ms":12400
  }'

Upload the raw bytes to the returned URL.

Send the voice memo

const result = await relay.chats.sendVoicememo(chatId, {
  attachment_id: allocation.attachment_id,
});

curl -sS -X POST \
  https://api.relayapp.im/v1/chats/$CHAT_ID/voicememo \
  -H "Authorization: Bearer $RELAY_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"attachment_id":"'$ATTACHMENT_ID'"}'

Relay rejects non-audio Attachments on this route. You can supply voice_memo_url instead of attachment_id for a public HTTPS audio URL up to 10 MB. Relay applies the same public-network, redirect, size, and Content-Type checks as other URL media.

Read the response

The response includes the Message ID, Chat, recipients, delivery status, and audio metadata. Relay Messenger for iOS renders the voice memo with inline playback.