Tracks

Update track

put/v1/track/{track_id}

Request

  • Base URL: https://api.audiodelivery.net
  • URL: https://api.audiodelivery.net/v1/track/{track_id}
  • Auth: HTTP bearer

Path parameters

track_idstring uuid required

Request body

idstring uuid
collection_idstring uuid
creator_idstring uuid
file_namestring
durationnumber
organization_indexstring
metadataobject
is_cover_overridableboolean
is_theme_overridableboolean
player_titlestring
player_subtitlestring
player_colorstring
player_color_lightstring

Derived read-only variant of player_color adjusted to stay legible on a light background.

player_color_darkstring

Derived read-only variant of player_color adjusted to stay legible on a dark background.

transcriptionstring nullable

Plain-text transcription as paragraphs when transcription is enabled for the organization. Null when unavailable. Language is auto-detected unless provisioned otherwise. Transcription is not a self-serve / selectable variant — contact AudioDN if you need it.

transcription_languagestring nullable

BCP-47 language code of the spoken source language for transcription (from automatic language detection, or a provisioned language override). Null when unavailable.

status'initializing' | 'processing' | 'fallback_processing' | 'ready' | 'incomplete' | 'failed'
base_pathstring

Durable delivery path prefix for this track's variant files. Each variant file is base_path plus its variant suffix and extension (e.g. {base_path}_preview.mp3).

base_urlstring uri

Durable delivery URL prefix: base_path served from the organization's unique audiodelivery.net subdomain. Append the variant suffix and extension, then sign for delivery (e.g. {base_url}_128.mp3).

Response

Updated track.

oktrue required
api_request_idstring uuid required
track_idstring uuid

Changes

No recorded changes to this operation across all 1 revision of this API.