Complete an upload
Call after the PUT succeeds. The file is then checked like a downloaded one. Needs a key with delivery:write.
POST
/
delivery
/
releases
/
{releaseId}
/
files
/
{fileId}
/
complete
Complete an upload
curl --request POST \
--url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"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"
}
}Authorizations
An API key from Settings → API in AMM Distro.
Path Parameters
Your ID for the release.
Pattern:
^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$file.id from the release's artwork or track audio.
Query Parameters
Required when the key covers more than one account.
Response
Accepted for checking.
Show child attributes
Show child attributes
⌘I
Complete an upload
curl --request POST \
--url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/files/{fileId}/complete"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"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"
}
}