Update Movie Details Using Match

You can update metadata for a movie 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 movie's metadata.

URL

PUT http://[IP address]:32400/library/metadata/[Movie ID]/match?guid=[Movie GUID]&name=[Movie Name]&year=[Movie Year]&X-Plex-Token=[PlexToken]

Parameters

NameDescription
IP addressThe IP address of the Plex Media server.
PlexTokenThe authentication Plex token.
Movie IDThe key associated with the movie to be updated. This key can be found by calling the Get All Movies API command and looking for the movie to be updated.
Movie GUIDThis is the unique identifier returned by the search for match API. Each SearchResult will have a guid attribute. It will be in the format plex://movie/[string value]. That GUID string is what will be used for this parameter value.
Movie NameThe name of the movie.
Movie YearThe year the movie was released.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.
404Not Found - The Movie 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 indicate a success.

The response consists of a single MediaContainer element with a few attributes.

MediaContainer Attributes
AttributeDescription
sizeThe number of movies.
identifierThe type of item.
mediaTagPrefixPrefix for the media tag.
mediaTagVersionMedia tag version.
Note: This could be a date and time value.

Examples

curl -X PUT http://[IP address]:32400/library/metadata/[Movie ID]/match?guid=[Movie GUID]&name=[Movie Name]&year=[Movie Year]&X-Plex-Token=[PlexToken]
import requests
plex_url = http://[IP address]:32400/library/metadata/[Movie ID]/match?guid=[Movie GUID]&name=[Movie Name]&year=[Movie Year]&X-Plex-Token=[PlexToken]
response = requests.put(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://[IP address]:32400/library/metadata/[Movie ID]/match?guid=[Movie GUID]&name=[Movie Name]&year=[Movie Year]&X-Plex-Token=[PlexToken]' -Method 'PUT'
Write-Output $response
Subscribe
Display