Create Media
Create a new media record (song).Example Request
POST /v1/media
{
"mediaBundleId": "bundle-123",
"name": "My Song",
"isrc": "US-ABC-12-34567",
"imageUrl": "https://placehold.co/1000x1000",
"audioUrl": "https://example.com/song.mp3",
"videoUrls": [
"https://example.com/video-1.mp4",
"https://example.com/video-2.mp4"
],
"youtubeUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"spotifyUrl": "https://open.spotify.com/track/1234567890",
"appleMusicUrl": "https://music.apple.com/us/album/1234567890",
}
Response
{
"success": true,
"message": "Media created",
"data": {
"mediaId": "media-123",
"name": "My Song"
}
}
Get Media
Retrieve media by ID.Example Request
GET /v1/media/{mediaId}
Response
{
"success": true,
"message": "Media found",
"data": {
"name": "My Song",
"mediaId": "media-id",
"artistId": "artist-id",
"mediaBundleId": "media-bundle-id",
"isrc": "US-ABC-12-34567",
"isActive": false,
"audioAssets": {
"DEFAULT": "audio-asset-id"
},
"videoAssets": [
{
"aspectRatio": "9x16",
"id": "video-asset-id"
}
],
"imageAssetId": "image-asset-id",
"textAssetsIds": {},
"youtubePluginId": "youtube-plugin-id",
"spotifyPluginId": "spotify-plugin-id",
"applePluginId": "apple-plugin-id",
}
}
Update Media
Example Request
PUT /v1/media/{mediaId}
{
"name": "Updated Song Name",
"imageUrl": "https://placehold.co/1000x1000",
"audioUrl": "https://example.com/updated-song.mp3",
}
Response
{
"success": true,
"message": "Media found",
"data": {
"name": "My Song",
"mediaId": "media-id",
"artistId": "artist-id",
"mediaBundleId": "media-bundle-id",
"isrc": "US-ABC-12-34567",
"isActive": false,
"audioAssets": {
"DEFAULT": "updated-audio-asset-id"
},
"videoAssets": [
{
"aspectRatio": "9x16",
"id": "video-asset-id"
}
],
"imageAssetId": "image-asset-id",
"textAssetsIds": {},
"youtubePluginId": "youtube-plugin-id",
"spotifyPluginId": "spotify-plugin-id",
"applePluginId": "apple-plugin-id",
}
}