Create or update a release

PUT

delivery

releases

{releaseId}

curl --request PUT \
  --url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Night Drive",
  "releaseDate": "2026-12-04",
  "genre": {
    "primary": "Electronic"
  },
  "artists": [
    {
      "name": "Nova",
      "spotifyId": "0OdUWJ0sBjDrqHygGUXeCF",
      "legalFirstName": "Nora",
      "legalLastName": "Vance"
    }
  ],
  "tracks": [
    {
      "externalId": "NOVA-004-01",
      "title": "Night Drive",
      "explicit": false,
      "audio": {
        "url": "https://masters.s3.amazonaws.com/nova/night-drive.wav"
      },
      "credits": [
        {
          "firstName": "Nora",
          "lastName": "Vance",
          "roles": [
            "Composer",
            "Producer",
            "Vocals"
          ],
          "share": 100
        }
      ]
    }
  ]
}
'

{
  "release": {
    "externalId": "NOVA-004",
    "id": "<string>",
    "accountId": "<string>",
    "kind": "new",
    "status": "draft",
    "title": "<string>",
    "version": "<string>",
    "type": "<string>",
    "releaseDate": "2023-12-25",
    "originalReleaseDate": "2023-12-25",
    "upc": "<string>",
    "catalogNumber": "<string>",
    "transfer": {
      "batch": "<string>"
    },
    "artwork": {
      "present": true,
      "file": {
        "id": "<string>",
        "source": "url",
        "status": "awaiting_upload",
        "error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
        "details": {}
      }
    },
    "tracks": [
      {
        "externalId": "<string>",
        "id": "<string>",
        "discNumber": 123,
        "trackNumber": 123,
        "title": "<string>",
        "isrc": "<string>",
        "durationMs": 123,
        "audio": {
          "present": true,
          "file": {
            "id": "<string>",
            "source": "url",
            "status": "awaiting_upload",
            "error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
            "details": {}
          }
        }
      }
    ],
    "storeLinks": {
      "spotify": "<string>",
      "appleMusic": "<string>",
      "deezer": "<string>",
      "tidal": "<string>",
      "amazonMusic": "<string>",
      "youtubeMusic": "<string>"
    },
    "submittedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "changed": true
}

Authorizations

Authorization

string

header

required

An API key from Settings → API in AMM Distro.

Path Parameters

releaseId

string

required

Your ID for the release.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$

Body

application/json

title

string

required

Maximum string length: 300

Example:

"Night Drive"

releaseDate

string<date>

required

The date it goes live in stores.

Example:

"2026-12-04"

genre

object

required

Show child attributes

artists

object[]

required

At least one primary artist.

Required array length: 1 - 20 elements

Show child attributes

tracks

object[]

required

The full track list. A track left out of a later PUT is removed.

Required array length: 1 - 100 elements

Show child attributes

accountId

string

Required when the key covers more than one account.

version

string

Maximum string length: 200

Example:

"Deluxe"

type

enum<string>

Defaults from the track count: 1–3 Single, 4–6 EP, 7+ Album.

Available options:

Single,

EP,

Album,

Compilation

originalReleaseDate

string<date>

Catalog transfers only: when it first came out. Can't be in the future.

Example:

"2019-04-01"

upc

string

12 or 13 digits with a valid check digit. Required for transfers; otherwise assigned at approval.

Example:

"036000291452"

catalogNumber

string

Maximum string length: 100

language

string

default:en

cLine

string

Maximum string length: 300

pLine

string

Sound recording copyright holder, without the year.

Maximum string length: 300

copyrightYear

integer

Defaults to the release year (the original year for transfers).

Required range: x >= 1900

artwork

From a URL · object

A file we download from your URL, or one you upload yourself. Leaving the field out of a later PUT keeps the current file.

From a URL
Upload it yourself

Show child attributes

transfer

object

Marks this as a catalog transfer. Then upc, originalReleaseDate and every track's isrc are required.

Show child attributes

Response

Updated.

release

object

Show child attributes

changed

boolean

⌘I

curl --request PUT \
  --url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Night Drive",
  "releaseDate": "2026-12-04",
  "genre": {
    "primary": "Electronic"
  },
  "artists": [
    {
      "name": "Nova",
      "spotifyId": "0OdUWJ0sBjDrqHygGUXeCF",
      "legalFirstName": "Nora",
      "legalLastName": "Vance"
    }
  ],
  "tracks": [
    {
      "externalId": "NOVA-004-01",
      "title": "Night Drive",
      "explicit": false,
      "audio": {
        "url": "https://masters.s3.amazonaws.com/nova/night-drive.wav"
      },
      "credits": [
        {
          "firstName": "Nora",
          "lastName": "Vance",
          "roles": [
            "Composer",
            "Producer",
            "Vocals"
          ],
          "share": 100
        }
      ]
    }
  ]
}
'

{
  "release": {
    "externalId": "NOVA-004",
    "id": "<string>",
    "accountId": "<string>",
    "kind": "new",
    "status": "draft",
    "title": "<string>",
    "version": "<string>",
    "type": "<string>",
    "releaseDate": "2023-12-25",
    "originalReleaseDate": "2023-12-25",
    "upc": "<string>",
    "catalogNumber": "<string>",
    "transfer": {
      "batch": "<string>"
    },
    "artwork": {
      "present": true,
      "file": {
        "id": "<string>",
        "source": "url",
        "status": "awaiting_upload",
        "error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
        "details": {}
      }
    },
    "tracks": [
      {
        "externalId": "<string>",
        "id": "<string>",
        "discNumber": 123,
        "trackNumber": 123,
        "title": "<string>",
        "isrc": "<string>",
        "durationMs": 123,
        "audio": {
          "present": true,
          "file": {
            "id": "<string>",
            "source": "url",
            "status": "awaiting_upload",
            "error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
            "details": {}
          }
        }
      }
    ],
    "storeLinks": {
      "spotify": "<string>",
      "appleMusic": "<string>",
      "deezer": "<string>",
      "tidal": "<string>",
      "amazonMusic": "<string>",
      "youtubeMusic": "<string>"
    },
    "submittedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "changed": true
}

Overview

Accounts

Releases

Files

Catalog transfers

Reference data

Ingestion check

Create or update a release

Authorizations

Path Parameters

Body

Response