{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/audiodelivery-net/json-schema/audiodelivery-net-track-schema.json",
  "title": "Track",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/audiodelivery-net-openapi.json#/components/schemas/Track",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "collection_id": {
      "type": "string",
      "format": "uuid"
    },
    "creator_id": {
      "type": "string",
      "format": "uuid"
    },
    "file_name": {
      "type": "string"
    },
    "duration": {
      "type": "number"
    },
    "organization_index": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    },
    "is_cover_overridable": {
      "type": "boolean"
    },
    "is_theme_overridable": {
      "type": "boolean"
    },
    "player_title": {
      "type": "string"
    },
    "player_subtitle": {
      "type": "string"
    },
    "player_color": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$"
    },
    "player_color_light": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$",
      "readOnly": true,
      "description": "Derived read-only variant of player_color adjusted to stay legible on a light background."
    },
    "player_color_dark": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$",
      "readOnly": true,
      "description": "Derived read-only variant of player_color adjusted to stay legible on a dark background."
    },
    "transcription": {
      "type": [
        "string",
        "null"
      ],
      "readOnly": true,
      "description": "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": {
      "type": [
        "string",
        "null"
      ],
      "readOnly": true,
      "description": "BCP-47 language code of the spoken source language for `transcription` (from automatic language detection, or a provisioned language override). Null when unavailable."
    },
    "status": {
      "type": "string",
      "enum": [
        "initializing",
        "processing",
        "fallback_processing",
        "ready",
        "incomplete",
        "failed"
      ]
    },
    "base_path": {
      "type": "string",
      "readOnly": true,
      "description": "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": {
      "type": "string",
      "format": "uri",
      "readOnly": true,
      "description": "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`)."
    }
  }
}