InfoSlides — put content on a TV or screen

"Show this photo on the lobby screen for an hour." Puts a photo or video on a screen as a temporary takeover, then the normal schedule returns. Give filePath (a local file) or mediaUrl (a public address), not both. The screen switches once processing finishes (seconds for a photo, longer for video): poll get_show_status with the returned ids and report the percent. A photo whose shape does not match the screen gets a blurred fill, not black bars.

Start the workspace's free AI Studio trial (7 days or 3 slides, prompt handler only). Once per workspace, so ask the person first. Calling it again while it runs returns the same trial.

Try a source's settings against the live service without saving anything, e.g. whether an RSS address works. Returns success and a plain-language message; a failed test is still an answer, not an error. Use before create_source. Limited to 10 calls a minute per workspace.

Undo the last change: puts back what an earlier call changed. Calls that change something return an undo field; pass its body.token here within 24 hours. A deleted slide comes back, an added slide, takeover or paired screen is removed. Not covered: deleting a slideshow (restore_slideshow brings one back), and screen settings. If the same thing was changed again since, the answer is NeedsClarification: ask the person before sending force=true, which overwrites that later change.

Replace the brand guide DRAFT with the whole guide given (admin only). It never changes what slides use: a person confirms it on the Brand page, so say it is waiting for their approval and give them brandPageUrl. Colours are #rrggbb; low text contrast comes back as a warning. Values are typed in, nothing is read from files. Call get_brand_guide first and send back the full guide with your changes.

Rename a screen, change its resolution (use 1080x1920 for a screen turned on its end), or save where it is so "this screen" can be found later with list_devices near the person's position (do that once, right after pairing). Send only what should change.

Rename a file in the media library, move it to a folder, or share it with other workspaces. Send only what should change. folderId moves it (moveToRoot puts it back at the top level); shared true lets other workspaces use it, false stops that. Only the workspace's own files can be changed.

Change a daily time window in place (ids from get_schedule): what it plays, its start or end (HH:mm, workspace time zone) or its priority. Send only what should change. A window that would overlap another is refused. Returns the entry with the same warnings as add_schedule_entry and an undo token. The default content has no times: change it with assign_schedule.

Change one slide that is already in a slideshow: make it stay on screen longer or shorter (durationSeconds, 1 to 300), or hide it and bring it back (hidden), like "hide the Christmas slide", "show the offer for 20 seconds". For a live-data slide it can also change what it shows: switch to another template (templateId) or content source (sourceId), change the value on it (overrideData, e.g. {"price":"1.990 kr"}; only the fields you send change, and null removes one), or set its countdown. Text inside an uploaded PowerPoint page cannot be edited this way: say so, and offer to replace the file with replace_slideshow_file. Only what you pass changes. To take the slide out for good use delete_slide.

Change a slide made with add_designed_slide, such as new wording or another background. Send the whole design: read it with get_slide_design, change what you need and send all of it back, since a field left out is not kept. The slide is drawn again in place and keeps its position, hidden state and visibility rules. The same length and colour checks apply as when adding it. The result carries an undo token that puts the old design back.

Change what is already playing on a screen: rename it, switch it between landscape and portrait, reorder the slides, turn the news ticker or the on-screen clock on or off, make every slide show for the same number of seconds, or force how it plays. Pass slideOrder as the complete list of slide ids in the sequence you want them shown. playbackMode overrides the usual rendered-video stream with a smooth HTML/CSS loop (or back again) for this one slideshow; pass "inherit" to drop the override and go back to whatever the workspace normally uses. Only what you pass changes. The screen picks the change up after a re-render: read the slideshow with get_slideshow until renderStatus is Completed before telling the person it is live.

Put fresh information on the screen: send today's menu, the new price, the current total, the updated opening hours. The display re-renders itself server-side — nobody has to touch the TV. The data must match the shape the template's example defines (see list_templates). For a slide on a push source the data goes to that source, exactly as push_data would send it. A restricted push-only (isk_dp_) key bound to the slide can call this, which is how an external system safely feeds one slide. Set dryRun=true to check the data without changing what is on screen.

Change a content source's name, config, fetch interval, or pause and resume it (ids from list_sources). To send data to a push source, use push_data instead.

Change a layout the workspace owns: title, html, css and/or schema (the data fields, e.g. {"fields":[{"name":"sales","type":"number"}]}). Send only what should change; new html without a schema takes its fields from the {{field}} tokens. Slides already using it pick up the change, so check get_template_usage first. A built-in layout cannot be changed: copy it with clone_template and change the copy.

Set the workspace time zone and/or locale. The time zone decides when schedules switch, what TV clocks show and when time-based slide conditions apply; set it early for a workspace outside Iceland. The locale sets number and date formats in rendered slides (changing it re-renders them).

Get the checkout link when the plan runs out: a second screen is needed, or the user wants self-updating slides fed by live data. Reach for this after a DeviceLimitReached or EntitlementRequired error rather than telling the user the thing cannot be done. Ask monthly or annual first and pass plan and billingPeriod: the result is then a Paddle checkout (/checkout?_ptxn=...) with its price, which needs no InfoSlides sign-in and pays for this workspace only. Without billingPeriod the link opens the plans page. Paying needs the person's clear yes to this plan at this price. Before they commit, tell them the price from the result, that it renews every month or year until cancelled, that they can cancel at any time and keep the plan until the period ends, and link https://infoslides.app/refund-policy. Then hand them the link, or open it and pay once they have said yes. A workspace that already pays gets its billing page, which needs a signed-in admin. The plan unlocks by itself once payment goes through.

Put a logo image from the user's computer (up to 5 MB) into the brand guide draft, for light backgrounds (slot light), dark backgrounds (dark) or as a small square mark (icon). Returns the brand guide. A person still confirms the draft on the Brand page. Workspace admins only.

Send a picture or video from the user's own computer to their workspace — a photo of the specials board, a poster, a logo, a promo clip. Use this when the file is local and has no public web address. Returns an asset id; pass it to add_media_slide as mediaAssetId to put it on the screen. For a large file, check get_upload_limits first.

Put an existing PowerPoint or PDF on a screen. Uploads a .pptx or .pdf from the local disk and turns it into screen content — the server reads the slide/page count and the file's own resolution and starts rendering it into a video stream. This is usually the quickest route when the user says they already have a presentation or a PDF deck.

Create the content that will play on a screen — the lunch menu, this week's offers, opening hours, staff notices, a welcome message for a hotel lobby. A slideshow is a deck of slides that loops on the display. Resolution defaults to 1920x1080 for a normal wall-mounted TV; use 1080x1920 for a portrait screen standing on its end, which is common for menu boards and shop windows. Slides can be added inline here or later with add_media_slide.