Update Music Artist Details Using Match
You can update metadata for a music artist using Plex's match feature and the API. This API command will use the information returned from the search for match API to update the artist's metadata.
URL
PUT http://[IP address]:32400/library/metadata/[Music Artist ID]/match?guid=[Music Artist GUID]&name=[Music Artist Name]&X-Plex-Token=[PlexToken]
Parameters
| Name | Description |
|---|---|
| IP address | The IP address of the Plex Media server. |
| PlexToken | The authentication Plex token. |
| Music Artist ID | The key associated with the artist to be updated. This key can be found by calling the Get All Music Artists API command and looking for the music artist to be updated. |
| Music Artist GUID | This is the unique identifier returned by the search for match API. Each SearchResult will have a guid attribute. It will be in the format mbid://[string value]. That GUID string is what will be used for this parameter value. |
| Music Artist Name | The name of the artist. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 401 | Unauthorized - The Plex token provided was not valid. |
| 404 | Not Found - The Music Artist ID value is incorrect. |
Response
An XML string is returned, but doesn't provide information about the update. If the status code is 200 and the XML is returned then that would indicated a success.
The response consists of a single MediaContainer element with a few attributes.
| Attribute | Description |
|---|---|
| size | The number of music artists. |
| identifier | The type of item. |
| mediaTagPrefix | Prefix for the media tag. |
| mediaTagVersion | Media tag version. Note: This could be a date and time value. |
Examples
Example 1
Update the music artist (ABBA) associated with ID 218548 on the Plex Media Server located at the IP address of 192.168.1.4 with the information associated with mbid://d87e52c5-bb8d-4da8-b941-9f4928627dc8 :
PUT http://192.168.1.4:32400/library/metadata/218548/match?guid=mbid://d87e52c5-bb8d-4da8-b941-9f4928627dc8&name=ABBA&X-Plex-Token=&X-Plex-Token=L6vkd7JtLHjsH5987vYY