Skip to main content
POST
https://enterprise.spacemedia.uk
/
api
/
v1
/
releases
/
{id}
Update Release
curl --request POST \
  --url https://enterprise.spacemedia.uk/api/v1/releases/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'title=Midnight Signals' \
  --form cover_art=null \
  --form 'label=Demo Label' \
  --form copyright_material=false \
  --form upc=5051234567890 \
  --form reference=DLG-2026-001 \
  --form remix_version= \
  --form genre=Electronic \
  --form secondary_genre=Ambient \
  --form language=English \
  --form explicit_content=false \
  --form format=single \
  --form gidr=null \
  --form 'description=A production-safe demo release used in API examples.' \
  --form 'artists={
  "id": 1042,
  "type": "Primary Artist"
}'
const form = new FormData();
form.append('title', 'Midnight Signals');
form.append('cover_art', 'null');
form.append('label', 'Demo Label');
form.append('copyright_material', 'false');
form.append('upc', '5051234567890');
form.append('reference', 'DLG-2026-001');
form.append('remix_version', '');
form.append('genre', 'Electronic');
form.append('secondary_genre', 'Ambient');
form.append('language', 'English');
form.append('explicit_content', 'false');
form.append('format', 'single');
form.append('gidr', 'null');
form.append('description', 'A production-safe demo release used in API examples.');
form.append('artists', '{
  "id": 1042,
  "type": "Primary Artist"
}');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://enterprise.spacemedia.uk/api/v1/releases/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://enterprise.spacemedia.uk/api/v1/releases/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nMidnight Signals\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cover_art\"\r\n\r\nnull\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"label\"\r\n\r\nDemo Label\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"copyright_material\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"upc\"\r\n\r\n5051234567890\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference\"\r\n\r\nDLG-2026-001\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"remix_version\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"genre\"\r\n\r\nElectronic\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"secondary_genre\"\r\n\r\nAmbient\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"explicit_content\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"format\"\r\n\r\nsingle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"gidr\"\r\n\r\nnull\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\nA production-safe demo release used in API examples.\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"artists\"\r\n\r\n{\r\n  \"id\": 1042,\r\n  \"type\": \"Primary Artist\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
import requests

url = "https://enterprise.spacemedia.uk/api/v1/releases/{id}"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nMidnight Signals\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cover_art\"\r\n\r\nnull\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"label\"\r\n\r\nDemo Label\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"copyright_material\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"upc\"\r\n\r\n5051234567890\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reference\"\r\n\r\nDLG-2026-001\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"remix_version\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"genre\"\r\n\r\nElectronic\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"secondary_genre\"\r\n\r\nAmbient\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"explicit_content\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"format\"\r\n\r\nsingle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"gidr\"\r\n\r\nnull\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\nA production-safe demo release used in API examples.\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"artists\"\r\n\r\n{\r\n  \"id\": 1042,\r\n  \"type\": \"Primary Artist\"\r\n}\r\n-----011000010111000001101001--"
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)
{
  "data": [
    {
      "id": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
      "uuid": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
      "title": "Midnight Signals",
      "status": "draft",
      "created_at": "2026-04-15T10:20:00+00:00",
      "viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
      "created_by": {
        "id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
        "uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
        "organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
        "organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
        "name": "Maya Chen",
        "full_name": "Maya Chen",
        "first_name": "Maya",
        "last_name": "Chen",
        "email": "maya.chen@example.test",
        "phone": "+442071838750",
        "language": "en",
        "country": "United Kingdom",
        "address": "22 Demo Lane, London",
        "photo": null,
        "profile_photo": null,
        "verified": true,
        "email_verified_at": "2026-04-10T08:15:00+00:00",
        "last_login_at": "2026-04-18T08:45:00+00:00",
        "created_at": "2026-03-20T09:00:00+00:00",
        "updated_at": "2026-04-18T08:45:00+00:00",
        "is_suspended": false,
        "suspended_at": null,
        "invitation_status": "accepted",
        "is_invited": false,
        "roles": [
          {
            "id": "role-admin-demo",
            "uuid": "role-admin-demo",
            "name": "Admin"
          }
        ]
      },
      "cover_art": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
      "image": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
      "resizedImage": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover-512.jpg",
      "numberOfTracks": 2,
      "scheduled_date": "2026-06-19",
      "version": null,
      "label": "Demo Label",
      "genre": "Electronic",
      "secondary_genre": "Ambient",
      "language": "English",
      "is_copyrighted": false,
      "copyright_links": [],
      "is_parental_advisory": false,
      "format": "single",
      "upc_code": "5051234567890",
      "reference_number": "DLG-2026-001",
      "gidr": null,
      "description": "A production-safe demo release used in API examples.",
      "price_category": "mid",
      "digital_release_date": "2026-06-19",
      "original_release_date": "2026-04-01",
      "license_type": "copyright",
      "creative_commons_license": null,
      "license_holder_year": 2026,
      "license_holder_name": "Demo Label Group Ltd",
      "sound_recordings_copyright_year": 2026,
      "sound_recordings_copyright_name": "Demo Label Group Ltd",
      "distribution": {
        "channels": [
          "spotify",
          "apple_music",
          "youtube_music"
        ]
      },
      "territories": [
        "GB",
        "US",
        "DE"
      ],
      "submitted_at": null,
      "artists": [
        {
          "id": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
          "uuid": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
          "name": "Nova Vale",
          "url": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
          "viewUrl": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
          "editRoute": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit",
          "artist_type": "Primary Artist",
          "spotify_id": "6dDemoNovaVale",
          "releases_count": 1,
          "tracks_count": 2,
          "total_releases": 1,
          "total_tracks": 2,
          "total_streams": 125000,
          "metadata": {
            "country": "GB"
          },
          "created_at": "2026-03-22T11:00:00+00:00",
          "updated_at": "2026-04-15T10:20:00+00:00"
        }
      ]
    }
  ]
}
{
  "success": false,
  "message": "Missing bearer token"
}
{
  "success": false,
  "message": "This action is unauthorized."
}
{
  "success": false,
  "message": "Resource not found"
}
{
  "success": false,
  "message": "Validation failed.",
  "errors": {
    "title": [
      "The title field is required."
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Accept
string

Use application/json for API responses.

Authorization
string

Bearer access token. Use Bearer <YOUR_ACCESS_TOKEN>.

X-User-Id
string

Optional user UUID to perform the request on behalf of a user in the same organization.

Path Parameters

id
integer
required

The ID of the release.

Body

multipart/form-data

The body is of type object.

Response

Success

The response is of type object.