PMS API `Move Hub` Endpoint doesn't appear to work

SwiftPanda16 · January 5, 2026, 7:18pm

I believe there is an error in the documentation. It should be

PUT /hubs/sections/{sectionId}/manage/{identifier}/move?after={after}

Example:

PUT /hubs/sections/1/manage/movie.recentlyreleased/move?after=movie.recentlyadded

See the implementation in the Python PlexAPI wrapper.

github.com/pushingkarmaorg/python-plexapi

plexapi/library.py

705be7148


      
          def move(self, after=None):
              """ Move a managed hub to a new position in the library's Managed Recommendations.
          
                  Parameters:
                      after (obj): :class:`~plexapi.library.ManagedHub` object to move the item after in the collection.
          
                  Raises:
                      :class:`plexapi.exceptions.BadRequest`: When trying to move a Hub that is not a Managed Recommendation.
              """
              if not self._promoted:
                  raise BadRequest('Collection must be a Managed Recommendation to be moved')
              key = f'/hubs/sections/{self.librarySectionID}/manage/{self.identifier}/move'
              if after:
                  key = f'{key}?after={after.identifier}'
              self._server.query(key, method=self._server._session.put)

Topic		Replies	Views
Can we edit the collection order via the API? Dev/API Corner	6	62	March 7, 2026
Give users more control over their hubs / compensate the removal of the manually managed Home screen Feature Suggestions	17	820	April 16, 2025
Change order of home screen organizations Plex Media Server server-windows	3	503	November 15, 2021
Homescreen reorder Feature Suggestions	3	144	August 18, 2023
Home Re-Ordering Feature Suggestions	10	135	November 13, 2023

PMS API `Move Hub` Endpoint doesn't appear to work

Related topics