Submit a release for distribution

Changed on

Existing v1 clients may omit expanded metadata and receive server defaults. New clients should provide distribution_store_ids, label, copyright credits, track_type, and role credits explicitly. A 422 validation_failed response carries a details array naming each offending field path, e.g. tracks[0].writers[0].name.

post/releases

Request

Request body

release_idstring
conversation_idstring
token_offsetboolean
distributorsobject
skip_adaptersboolean

Example request

{
  "release": {
    "audio_language": "en",
    "metadata_language": "en",
    "language_and_script_code": "ja-Kana",
    "contributors": [
      {
        "role": "Producer"
      }
    ],
    "artist_locals": [
      {
        "language_and_script_code": "ja-Latn"
      }
    ],
    "title_locals": [
      {
        "language_and_script_code": "ja-Latn"
      }
    ]
  },
  "tracks": [
    {
      "language": "en",
      "language_and_script_code": "ja-Kana",
      "contributors": [
        {
          "role": "Producer"
        }
      ],
      "artist_locals": [
        {
          "language_and_script_code": "ja-Latn"
        }
      ],
      "title_locals": [
        {
          "language_and_script_code": "ja-Latn"
        }
      ]
    }
  ]
}

Response

Submitted release

Changes

    • info

      added the new optional request property ///

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property ////

    • info

      added the new optional request property //

    • info

      added the new optional request property //