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
| Name | Description |
|---|---|
| IP address | The IP address of the Plex Media server. |
| PlexToken | The authentication Plex token. |
| Movie ID | The 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 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 plex://movie/[string value]. That GUID string is what will be used for this parameter value. |
| Movie Name | The name of the movie. |
| Movie Year | The year the movie was released. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 401 | Unauthorized - The Plex token provided was not valid. |
| 404 | Not 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 indicated a success.
The response consists of a single MediaContainer element with a few attributes.
| Attribute | Description |
|---|---|
| size | The number of movies. |
| 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 movie (Persuasion) associated with ID 289283 on the Plex Media Server located at the IP address of 192.168.1.4 with the information associated with plex://movie/5d776840999c64001ec317ab :
PUT http://192.168.1.4:32400/library/metadata/289283/match?guid=plex://movie/5d776840999c64001ec317ab&name=Persuasion&year=1995&X-Plex-Token=&X-Plex-Token=L6vkd7JtLHjsH5987vYY