📖
API documentation
  • 🚀 Dashboard
  • 📅Changelog
  • 💾Deprecations
  • 🛠️Resources
    • Artist
    • ArtistRole
    • AppleArtist
    • AssetAttachment
    • Availability
    • Booklet
    • Company
    • Continent
    • Currency
    • Customisation
    • Distributor
    • DistributorPriceCode
    • DistributorProductSubgenres
    • Dsp
    • DspState
    • DspTag
    • DspUploadIdentification
    • Gender
    • ImportTask
    • ImportTask [NEW]
    • Label
    • Language
    • Offer
    • Playlist
    • Product
    • ProductGenre
    • ProductType
    • Quotas
    • Record
    • Retail
    • Role
    • Right
    • SendTask
    • SendTaskFactory
    • SpotifyArtist
    • Tag
    • Territory
    • Track
    • TrackOffer
    • TrackVideo
    • Video
    • Webhooks
  • 💡Best practices
    • JSON API documentation
    • Perform your first request
    • Make specific JSON API request
    • Manage the static resources
    • List of common HTTP status codes
    • ⁉️Timeouts and Errors
  • 🖥️Tutorials
    • Full Scenario
    • Managing artists
    • Upload a Dolby Atmos
    • Set a timed release
    • Update Scenario
  • 🔗Exports
    • Daily Trends export
  • 📡Webhooks
    • Presentation
Powered by GitBook
On this page
  1. 🖥️Tutorials

Upload a Dolby Atmos

PreviousManaging artistsNextSet a timed release

Last updated 5 months ago

CtrlK

In order to upload a Dolby Atmos record, simply create a new ImportTask object, associate the audio file (we accept .wav as well as .zip formats) and use the master_type attribute to stipulate that you want to import a Dolby Atmos master audio.

Here is an example of a query to create a Dolby Atmos record:

response = RestClient.post(
            "https://api.idol.io/api/v2/import-tasks",
           {
              "data": {
                "attributes": {
                  "precision": '24',
                  "master-type": 'dolby_atmos',
                  "status": 'uploaded',
                  "url": 'https://<download_record_url>',
                },
                "relationships": {
                  "attachable": {
                    "data": {
                      "id": "<ID>",
                      "type": "tracks"
                    }
                  }
                },
                "type": "import-tasks"
              }
            }.to_json,
            "Authorization": "Bearer <token>",
            "Content-Type": "application/vnd.api+json"
          )

import_task = JSON.parse(response)['data']
# => [{"id"=>"<ID>", "type"=>"import-tasks"...}]

You can find more details about the ImportTask resource here.