Submit Track Document

curl --request POST \
  --url https://enterprise.spacemedia.uk/api/v1/tracks/{id}/document \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'links=Publishing agreement: https://demo-label.example.test/contracts/midnight-signals' \
  --form file=@ownership-document.pdf

const form = new FormData();
form.append('links', 'Publishing agreement: https://demo-label.example.test/contracts/midnight-signals');
form.append('file', '@ownership-document.pdf');

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

options.body = form;

fetch('https://enterprise.spacemedia.uk/api/v1/tracks/{id}/document', 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/tracks/{id}/document",
  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=\"links\"\r\n\r\nPublishing agreement: https://demo-label.example.test/contracts/midnight-signals\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n@ownership-document.pdf\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/tracks/{id}/document"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"links\"\r\n\r\nPublishing agreement: https://demo-label.example.test/contracts/midnight-signals\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n@ownership-document.pdf\r\n-----011000010111000001101001--"
headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "data": [
    {
      "id": "0b4edc61-cf2d-4a92-bb20-37051d52d2f8",
      "title": "Midnight Signals",
      "links": [
        "https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav",
        "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"
      ],
      "metadata": {
        "version": "Original Mix",
        "secondary_genre": "Ambient"
      },
      "duration": 196,
      "language": "English",
      "iswc_code": "T0345246801",
      "isrc_code": "GBSMU2600001",
      "lyrics": null,
      "is_available_separately": true,
      "is_parental_advisory": false,
      "license_holder_year": 2026,
      "license_holder_name": "Demo Label Group Ltd",
      "primary_genre": "Electronic",
      "secondary_genre": "Ambient",
      "track_version": "Original Mix",
      "preview_url": "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3",
      "description": "Demo track used for public API examples.",
      "notes": "Demo track used for public API examples.",
      "input_format": "wav",
      "output_format": "wav",
      "original_file": "midnight-signals.wav",
      "documents_requested": false,
      "request_notice": null,
      "viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
      "uploaded_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"
          }
        ]
      },
      "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."
    ]
  }
}