Skip to main content
POST
Use this endpoint when your media file is already hosted at a public URL. For local files, use Submit from local file instead.
Processing is asynchronous — the API returns a transcription_id immediately. Use Get Transcription Details or webhooks to track completion.
The url must be publicly accessible with no authentication required. The download has a 60-second timeout — use a fast, stable URL.
For supported formats, file size limits, and duration limits, see Rate Limits & Quotas.
participant_id and evaluator_id are optional. If provided, they must exist and belong to your account.
The optional period_date field sets when the recording was made — a date (YYYY-MM-DD) or an ISO 8601 datetime, time optional — and overwrites the transcription’s created_at, which all time-based analytics are derived from. It behaves identically to the same field on Submit from local file — see the accepted formats and gotchas there. There is no way to correct the date afterwards: delete and resubmit with the right period_date.
period_date is validated before the audio is downloaded from url — a malformed date fails fast with a 400 and does not consume the 60-second download.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
configuration_id
string<uuid>
required

The unique identifier of the configuration to use for processing.

​
url
string<uri>
required

A publicly accessible URL to the audio or video file to transcribe. Must require no authentication. Subject to a 60-second download timeout.

​
name
string

Optional custom name for the transcription job.

​
participant_id
string<uuid>

Optional. Link this transcription to a participant. Must exist and belong to your account.

​
evaluator_id
string<uuid>

Optional. Link this transcription to an evaluator. Must exist and belong to your account.

​
period_date
string

Optional. When the recording was made — a date (YYYY-MM-DD) or an ISO 8601 datetime; the time is optional. Same behaviour as on /request-upload-url: overwrites the transcription's created_at. Validated before the audio is downloaded from url — a malformed value fails fast with 400 without consuming the 60-second download.

Pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:?\d{2})?)?$
Example:

"2026-04-15T14:30:00Z"

Response

201 - application/json

Transcription job created successfully. Processing has started asynchronously.

​
data
object