Devices and streams

Play a slideshow on screens for a temporary period or until cancelled

Temporarily overrides one or more screens with a slideshow from startsAt (default now) until endsAt or for durationMinutes, or indefinitely until ended: {"deviceIds": ["..."], "slideshowId": "...", "startsAt": "2026-12-31T23:50:00", "endsAt": "2027-01-01T00:30:00"} (or deviceId for one screen). Times with Z or an offset are exact instants; times without a zone are workspace local time. Crossing midnight is fine; endsAt must be after startsAt. Returns the takeover (a list, one per screen, when deviceIds names several), each with its id for DELETE /v1/takeovers/{id}. A slideshow that has never finished rendering takes over only once its first render completes; until then the screens keep their content.

post/v1/takeovers

Request

  • Base URL: https://infoslides.app
  • URL: https://infoslides.app/v1/takeovers
  • Auth: none declared

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.

Request body

deviceIdstring uuid nullable
deviceIdsstring[] nullable
slideshowIdstring uuid
durationMinutesinteger nullable
startsAtstring date-time nullable
endsAtstring date-time nullable

Response

OK

Changes

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