Update TV Show Series Details Using Match

You can update metadata for a TV show series 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 series' metadata.


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


IP addressThe IP address of the Plex Media server.
PlexTokenThe authentication Plex token.
TV Show IDThe key associated with the TV show to be updated. This key can be found by calling the Get All TV Shows API command and looking for the TV show series to be updated.
TV Show 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://show/[string value]. That GUID string is what will be used for this parameter value.
TV Show NameThe name of the TV show.
TV Show YearThe year the TV show debuted.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.
404Not Found - The TV Show ID value is incorrect.


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.

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


Example 1

Update the TV show (Joy of Painting) associated with ID 289285 on the Plex Media Server located at the IP address of with the information associated with plex://show/5d9c086e3c3f87001f34fc00 :

PUT Joy of Painting&year=1983&X-Plex-Token=&X-Plex-Token=L6vkd7JtLHjsH5987vYY