---
title: "Show a photo or video on a screen right now"
method: POST
path: "/v1/devices/{id}/show"
tags: ["Devices and streams"]
---

# Show a photo or video on a screen right now

`POST /v1/devices/{id}/show`

## Request

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

"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.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Response `200`

OK

---

[API](https://skmtc.dev/infoslides/apis/infoslides-agent-api.md) · [All operations](https://skmtc.dev/infoslides/apis/infoslides-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infoslides/apis/infoslides-agent-api/revisions/d15bb7f8ee9d?raw)