Recordings
Get recording metadata
Section titled “Get recording metadata”GET /v1/collections/{collection_id}/users/{user_id}/recordingResponse 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"}Headless upload
Section titled “Headless upload”POST /v1/recordings/uploadUpload 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
| Field | Type | Required | Description |
|---|---|---|---|
audio | file | ✅ | Audio file (webm, mp4, wav). Max 5MB |
duration | integer | Duration in seconds |
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"}