Skip to main content
POST
Import a public audio URL

Authorizations

Authorization
string
header
required

Personal or organization scoped ingest key from Build

Headers

Idempotency-Key
string

Stable key for uncertain retries

Maximum string length: 256
X-Workspace-Id
string

Workspace selection before audio transfer

Body

application/json
url
string<uri>
required

Public HTTPS audio URL, no userinfo or fragment

workspace_id
string
external_conversation_id
string
Maximum string length: 512
revision
string
pricing_tier
enum<string>
default:standard

Chosen per submission. Reserved work starts weekends or 7 p.m.–7 a.m. America/New_York. Keep the same tier on idempotent retries.

Available options:
standard,
reserved
requested_definition_version_ids
string<uuid>[]

Response

Admitted asynchronously (or replayed)

interactionId
string<uuid>
required
replayed
boolean
required
inputRevision
string
transcriptRevision
string
mediaAssetId
string
transcriptionWorkflowId
string | null

Null while the submission waits for funding or a Reserved window.