Skip to content
Back to Nouncify

Recordings

GET /v1/collections/{collection_id}/users/{user_id}/recording

Response 200 OK

{
"has_recording": true,
"recording_id": "recording-uuid",
"duration_seconds": 3,
"recorded_at": "2026-04-01T00:00:00Z",
"play_link": "https://api.nouncify.com/p/HkJ3mN8x",
"play_url": "https://api.nouncify.com/p/HkJ3mN8x.mp3"
}
POST /v1/recordings/upload

Upload an audio recording without using the embed widget. Useful for mobile apps or custom UIs.

Headers:

  • X-Embed-Token: A valid embed token (emb_tk_...)

Body: multipart/form-data

FieldTypeRequiredDescription
audiofile✅Audio file (webm, mp4, wav). Max 5MB
durationintegerDuration in seconds
Terminal window
curl -X POST https://api.nouncify.com/v1/recordings/upload \
-H "X-Embed-Token: emb_tk_..." \
-F "audio=@recording.webm" \
-F "duration=3"

Response 201 Created

{
"recording_id": "recording-uuid",
"duration_seconds": 3,
"play_link": "https://api.nouncify.com/p/HkJ3mN8x",
"play_url": "https://api.nouncify.com/p/HkJ3mN8x.mp3"
}