Devices and streams

Show a photo or video on a screen right now

"Show this on the lobby screen" in one call: send a photo or video (multipart/form-data, a file part, or a mediaUrl field — exactly one) plus optional until (default 30 minutes) and caption. Stores the file (a mediaUrl download is streamed to disk, up to 1 GB), creates a one-slide slideshow named from caption or today's date, and starts a temporary takeover (APX-12) until until. A portrait photo/video on a landscape screen (or vice versa) gets a blurred, darkened fill rather than plain black bars. Returns at once with the ids and a status link; the screen switches once processing finishes — poll GET /v1/devices/{id}/show/{mediaAssetId}?slideshowId= for the combined percent.

post/v1/devices/{id}/show

Request

  • Base URL: https://infoslides.app
  • URL: https://infoslides.app/v1/devices/{id}/show
  • Auth: none declared

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Client-generated key (max 128 chars). Repeating a request with the same key within 24 hours replays the original response and sets Idempotent-Replay: true instead of re-executing.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.