---
title: "Update track"
method: PUT
path: "/v1/track/{track_id}"
tags: ["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_id` string, uuid, required

## Request body

- Track
  - `id` string, uuid
  - `collection_id` string, uuid
  - `creator_id` string, uuid
  - `file_name` string
  - `duration` number
  - `organization_index` string
  - `metadata` object
  - `is_cover_overridable` boolean
  - `is_theme_overridable` boolean
  - `player_title` string
  - `player_subtitle` string
  - `player_color` string
  - `player_color_light` string: Derived read-only variant of player_color adjusted to stay legible on a light background.
  - `player_color_dark` string: Derived read-only variant of player_color adjusted to stay legible on a dark background.
  - `transcription` string, 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_language` string, 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_path` string: 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_url` string, 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 `200`

Updated track.

- object
  - `ok` true, required
  - `api_request_id` string, uuid, required
  - `track_id` string, uuid
  - `track` Track
    - `id` string, uuid
    - `collection_id` string, uuid
    - `creator_id` string, uuid
    - `file_name` string
    - `duration` number
    - `organization_index` string
    - `metadata` object
    - `is_cover_overridable` boolean
    - `is_theme_overridable` boolean
    - `player_title` string
    - `player_subtitle` string
    - `player_color` string
    - `player_color_light` string: Derived read-only variant of player_color adjusted to stay legible on a light background.
    - `player_color_dark` string: Derived read-only variant of player_color adjusted to stay legible on a dark background.
    - `transcription` string, 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_language` string, 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_path` string: 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_url` string, 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`).

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource not found.

---

[API](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api.md) · [All operations](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/revisions/57d355fc6a44?raw)