Skip to main content
PATCH
/
media
/
{mediaId}
Update media
curl --request PATCH \
  --url https://api.blurb.fm/v1/media/{mediaId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Song",
  "audioAssets": {},
  "videoAssets": [],
  "imageAssetId": "",
  "youtubePluginId": "",
  "spotifyPluginId": "",
  "applePluginId": "",
  "plainTextLyrics": "The plain text lyrics of the media.",
  "language": "en",
  "isrc": "US-1234567890",
  "trackVersion": "Live",
  "trackNumber": 1,
  "discNumber": 1,
  "imageUrl": "https://placehold.co/1000x1000",
  "videoUrls": [
    "https://placehold.co/1000x1000",
    "https://placehold.co/1000x1000"
  ],
  "audioUrl": "https://placehold.co/1000x1000",
  "instrumentalAudioUrl": "https://placehold.co/1000x1000",
  "youtubeUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "spotifyUrl": "https://open.spotify.com/track/1234567890",
  "appleMusicUrl": "https://music.apple.com/us/album/1234567890",
  "clientRef": "1234567890"
}
'
{
  "success": true,
  "message": "Media updated",
  "data": {
    "orgId": "example",
    "createdAt": {
      "seconds": 3,
      "nanoseconds": 3
    },
    "updatedAt": {
      "seconds": 3,
      "nanoseconds": 3
    },
    "mediaId": "example",
    "mediaBundleId": "example",
    "artistId": "example",
    "name": "example",
    "isActive": null,
    "audioAssets": null,
    "videoAssets": null,
    "textAssetsIds": null,
    "imageAssetId": null,
    "youtubePluginId": null,
    "spotifyPluginId": null,
    "applePluginId": null,
    "externalIds": {
      "appleMusic": null,
      "spotify": null,
      "youtube": null
    },
    "plainTextLyrics": null,
    "language": null,
    "isrc": null,
    "trackVersion": null,
    "trackNumber": null,
    "discNumber": null,
    "clientRef": null
  }
}

Path Parameters

​
mediaId
string
required
Example:

"my-media-id"

Body

application/json

The request to update media.

​
name
string
required

The name of the media.

Example:

"My Song"

​
audioAssets
object
​
videoAssets
object[]
​
imageAssetId
string
default:""
​
youtubePluginId
string
default:""
​
spotifyPluginId
string
default:""
​
applePluginId
string
default:""
​
plainTextLyrics
string | null

The plain text lyrics of the media.

Example:

"The plain text lyrics of the media."

​
language
enum<string> | null

The language of the media.

Available options:
en,
hi,
zh,
es,
pt,
fr,
ja,
de
Example:

"en"

​
isrc
string
default:""

The ISRC of the media.

Example:

"US-1234567890"

​
trackVersion
string | null
default:""

The track version of the media. e.g. Live, Acoustic, etc.

Example:

"Live"

​
trackNumber
number | null

The track number of the media. e.g. 1, 2, 3, etc.

Example:

1

​
discNumber
number | null

The disc number of the media. e.g. 1, 2, 3, etc.

Example:

1

​
imageUrl
string

The URL of the image asset.

Example:

"https://placehold.co/1000x1000"

​
videoUrls
string[]

The URLs of the video assets.

Example:
[
  "https://placehold.co/1000x1000",
  "https://placehold.co/1000x1000"
]
​
audioUrl
string

The URL of the audio asset.

Example:

"https://placehold.co/1000x1000"

​
instrumentalAudioUrl
string

The URL of the instrumental audio asset.

Example:

"https://placehold.co/1000x1000"

​
youtubeUrl
string

The URL of the YouTube asset.

Example:

"https://www.youtube.com/watch?v=dQw4w9WgXcQ"

​
spotifyUrl
string

The URL of the Spotify asset.

Example:

"https://open.spotify.com/track/1234567890"

​
appleMusicUrl
string

The URL of the Apple Music asset.

Example:

"https://music.apple.com/us/album/1234567890"

​
clientRef
string
default:""

The client reference for the media

Example:

"1234567890"

Response

Media updated successfully

​
success
boolean
required

Whether the request was successful

Example:

true

​
message
string | null
required

Message from the API

Example:

"Media updated"

​
data
object
required

The response from the Media PATCH request.

Example:
{
  "orgId": "example",
  "createdAt": { "seconds": 3, "nanoseconds": 3 },
  "updatedAt": { "seconds": 3, "nanoseconds": 3 },
  "mediaId": "example",
  "mediaBundleId": "example",
  "artistId": "example",
  "name": "example",
  "isActive": null,
  "audioAssets": null,
  "videoAssets": null,
  "textAssetsIds": null,
  "imageAssetId": null,
  "youtubePluginId": null,
  "spotifyPluginId": null,
  "applePluginId": null,
  "externalIds": {
    "appleMusic": null,
    "spotify": null,
    "youtube": null
  },
  "plainTextLyrics": null,
  "language": null,
  "isrc": null,
  "trackVersion": null,
  "trackNumber": null,
  "discNumber": null,
  "clientRef": null
}