Skip to main content
POST
Start a large-file upload

Authorizations

X-API-Key
string
header
required

Your Omnia API key (om_… or ck_…)

Headers

X-Languages
string

Comma-separated BCP-47 codes (up to 10), or auto on its own to detect the language. Defaults to fi-FI,sv-SE. Also accepted as ?languages=. See GET /languages for supported codes.

Example:

"fi-FI,sv-SE"

X-Metadata
string

JSON passed through unchanged to usage webhooks.

Example:

"{\"callId\": \"abc-123\"}"

X-Content-Type
string
required

MIME type of the file you will upload. The PUT must send the same Content-Type.

Example:

"audio/mp4"

X-Diarization
string

Response

Upload URL issued

operationId
string
uploadUrl
string
uploadMethod
string
Example:

"PUT"

uploadContentType
string
expiresInSeconds
integer
Example:

3600

startUrl
string
pollUrl
string