TRMNL Octri Demo
POST/api/devices/{device_id}/mashups

Add a mashup to a device playlist

Splits one screen between plugin settings. getDevice lists the layouts the device can show and the positions each layout has. The 1x1 layout adds a plain playlist item instead of a mashup.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
device_idintegerrequired
Device id
contentsobjectrequired
Plugin setting id by position; a position left out renders empty
grid_configarray<object>optional
The cells of a 3x3 layout only
layoutstringrequired
One of the layouts getDevice lists for the device
Allowed:1x11Tx1B1Lx1R1Tx2B2Tx1B1Lx2R2Lx1R2x23x3

4 status codes
200Added to the playlist
dataobjectoptional
401Unauthorized
errorstringoptional
404Device belongs to another user
422A layout that does not exist

Error handling

A 401 is returned: Unauthorized. A 404 is returned: Device belongs to another user. A 422 is returned: A layout that does not exist.