TRMNL Octri Demo
PUT/api/devices/{device_id}/playlist_items/order

Reorder a device playlist

Reorders the playlist items assigned to a device. Supply playlist_item_ids in the order you want the items to appear, including every item on the device. The device must belong to the authenticated user.

1 parameter · 1 body field
device_idintegerrequired
The unique identifier of the device whose playlist you want to reorder.

The ordered list of playlist item IDs for the device.

playlist_item_idsarray<integer>required
The playlist item IDs in the order they should appear. Include every item on the device.

4 status codes
200Returns a response whose `data` object includes a `success` value indicating whether the playlist was reordered.
dataobjectoptional
401Returned when the request is unauthorized.
errorstringoptional
404Returned when the device belongs to another user.
422Returned when the IDs do not identify every playlist item on the device.

Error handling

A 401 is returned when the request is unauthorized. A 404 is returned when the device belongs to another user. The device_id path parameter must identify a device you can access, and playlist_item_ids must include every item on that device; incomplete or invalid item IDs return a 422.