Access: organization users with track permissions; X-User-Id may target a same-organization user where allowed.
GET
https://enterprise.spacemedia.uk
/
api
/
v1
/
tracks
/
{trackId}
/
assign
/
{releaseId}
Assign Track to Release
curl --request GET \
--url https://enterprise.spacemedia.uk/api/v1/tracks/{trackId}/assign/{releaseId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://enterprise.spacemedia.uk/api/v1/tracks/{trackId}/assign/{releaseId}', 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/{trackId}/assign/{releaseId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/{trackId}/assign/{releaseId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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."
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Use application/json for API responses.
Bearer access token. Use Bearer <YOUR_ACCESS_TOKEN>.
Optional user UUID to perform the request on behalf of a user in the same organization.
Path Parameters
The ID of the track.
The ID of the release.
Query Parameters
Search term scoped to the authenticated organization.
Response
Success
The response is of type object.
Previous
Remove Track from ReleaseAccess: organization users with track permissions; `X-User-Id` may target a same-organization user where allowed.
Next
⌘I
Assign Track to Release
curl --request GET \
--url https://enterprise.spacemedia.uk/api/v1/tracks/{trackId}/assign/{releaseId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://enterprise.spacemedia.uk/api/v1/tracks/{trackId}/assign/{releaseId}', 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/{trackId}/assign/{releaseId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/{trackId}/assign/{releaseId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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."
]
}
}