Plex icon

Plex

Interact with Plex Media Server API

Collection → Add Items

AI-generated

Summary

Add one or more media items to a specified Plex collection by their rating keys.

Inputs

  • Collection Rating Key (required) — The unique rating key (ID) of the collection to which items will be added.
  • Machine Identifier (required) — The machine identifier of the Plex server hosting the collection.
  • Item Rating Keys (required) — A comma-separated list of rating keys (IDs) of the media items to add to the collection.

Output shape

a list of objects representing the updated collection items.

The response corresponds to the updated items in the target collection. The operation expects all required input parameters to be provided; errors may occur if invalid keys or identifiers are used.

Examples

Example 1: Add two media items to a collection.

Set Collection Rating Key to '1234', Machine Identifier to Plex server ID 'abcdef', and Item Rating Keys to '5678,9012'.

Discussion