Skip to main content
POST
Generate a pre-signed S3 URL for uploading a recording audio file. Upload the audio bytes directly to S3 using the returned URL, then call Complete Upload.

Authentication

This endpoint accepts either an API key or a device token.

Path Parameters

string
required
The recording’s unique identifier.

Request Body

string
Audio MIME type. Defaults to audio/opus.
integer
Expected file size in bytes. This is accepted for compatibility but the current upload URL response does not echo it.

Response

Returns a pre-signed S3 upload URL and metadata needed by clients.

Response Fields

Uploading the File

Use the returned URL directly:
cURL
After S3 upload succeeds, call Complete Upload.