List Countdown Music

List user's countdown music tracks

Info

Required scope: studio.read

Warning

This method requires authentication

Retrieve a list of audio tracks available to the authenticated user for use as countdown music in Studio. Each track ships one or more sources (encoded variants of the same audio), so consumers can pick the codec that suits them.

Tracks can optionally be linked to a brand via the brandId field. When brandId is null, the track is part of the default catalog and available to all of the user's brands. Default catalog entries are flagged with isDefault: true.

curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/studio/audio/countdown-music

Response

Success

Error

{
  "tracks": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "filename": "countdown-uplift.m4a",
      "brandId": null,
      "isDefault": true,
      "sources": [
        {
          "url": "https://studio-assets.restream.io/audio/countdown/uplift.m4a",
          "duration": 60,
          "bitrate": 192000,
          "codec": "Aac"
        },
        {
          "url": "https://studio-assets.restream.io/audio/countdown/uplift.opus",
          "duration": 60,
          "bitrate": 128000,
          "codec": "Opus"
        }
      ]
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "filename": "brand-intro.mp3",
      "brandId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "isDefault": false,
      "sources": [
        {
          "url": "https://studio-assets.restream.io/audio/user/brand-intro.mp3",
          "duration": 45,
          "bitrate": 256000,
          "codec": "Mpeg"
        }
      ]
    }
  ]
}