Voice memos

​

Send from a public URL

curl -sS -X POST "https://api.relayapp.im/v1/messages" \
  -H "Authorization: Bearer $RELAY_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: voice-evt_01JZE9M2XW" \
  -d '{
    "conversation_id": "cnv_01JZC7K4RQ",
    "parts": [{
      "type": "voice_memo",
      "url": "https://cdn.example.com/replies/answer.m4a",
      "duration_ms": 18400
    }]
  }'

​

Send an uploaded file

{
  "conversation_id": "cnv_01JZC7K4RQ",
  "parts": [{
    "type": "voice_memo",
    "attachment_id": "att_01KXGWNZFRF5BH4959T6JYD9SM",
    "duration_ms": 18400
  }]
}

​

Voice memo or audio attachment

​

Rules

• Pass exactly one of url or attachment_id.
• duration_ms is optional and accepts a non-negative integer.
• Relay validates the audio/* MIME family for uploaded files and does not transcode them. M4A/AAC (audio/mp4) is the recommended interoperable format; MP3 and WAV are also playable by Relay’s AVFoundation player.
• Voice memos use the normal message response, history, replies, reactions, idempotency, and delivery/read receipts. There is no second voice-memo delivery pipeline.

​

Next steps

• Attachments
• Sending messages