Publish
Publish pushes one still image to one device. The frame pulls and displays it once it is online.
Body
The guide allows either:
- an image file, or
- an image URL
Not a playlist and not video. For a rotating album, either publish on your own schedule or use CMS Slideshow / Campaigns.
Play progress
After you publish, query that job:
| State | Meaning |
|---|---|
| Processing | Accepted; the frame has not finished |
| Success | The platform considers the play done |
| Failure | The job did not complete; retry or inspect the device |
A successful HTTP accept is not the same as the panel having flipped. Always read progress (or the device’s later history) before you tell the end user it is on screen.
Request shapes are in the Apifox preview.