InfoSlides — put content on a TV or screen

See the latest items a source has fetched, newest first: title, body, imageUrl, url, fetchedAt and expiresAt. Use it to check what a slide on this source would show.

Check a source. For a push source: when data last arrived (lastReceivedAt), whether its slides are showing data (isShowingData, false before the first push or after the data went stale), the staleness timeout, and which slides it feeds; use it to confirm a system is actually sending. For a fetched source (RSS, weather, etc.): lastFetchedAt and health (Healthy, Degraded or Failing) with lastError in plain words, consecutiveFailures and lastSuccessAt, with the push fields empty.

Get the link that makes the content appear on the TV — the last step of any setup. Hand over playerUrl: opened in the smart TV's browser or the InfoSlides TV app, it plays the content correctly whichever way this screen is set up to play — the usual rendered-video stream or a live HTML/CSS loop. hlsUrl is the raw HLS manifest for something that only speaks HLS (an ffplay-style player, an old TV app build); it comes back null whenever the screen is playing an HTML loop, so check it before handing it out — do not assume it is always populated. The links are stable, so the screen keeps working as content changes. A StreamNotReady warning means nothing is playable yet — usually because the content is still rendering.

Read one self-updating layout: title, sampleJson (its data fields with example values, the shape a push to its source must send), html and css. Read it before changing it with update_template.

Where a layout is used in this workspace: slideCount, slideshowCount and the slides (slideId, slideshowId, slideshowTitle). Check it before deleting or reworking a layout.

Check what this account is allowed to do before planning any screen work: workspace name, owner, whether their email is confirmed, which plan they are on, how many screens are in use out of the allowance, and the scope of the API key in use. Call this early — designing around the limits beats discovering them through errors halfway through a setup.

Check what an upload can be before sending one: storageUsedBytes, storageLimitBytes, storageFreeBytes, maxFileBytes (the largest upload; a file must be a little smaller) and acceptedFileTypes. Call it before a large upload, or after a quota or too-large error, instead of trying again.

"How are my screens?" in one call: a sentence to read out ("11 of 12 screens are online; Lobby has been offline since 09:12."), every screen with online and lastSeenAt, usage against the plan, and problems most urgent first (offline screens, failed renders, slideshows no screen plays, expired plan, limits near full), each with a code, a message and a ready-made fix. Empty problems means all is well.

"Which screen is this?" Shows each online screen's own name in large text (or just the given ones) for about 90 seconds so the person can read out the name they see. The result lists each screen's deviceId and name, and says how many seconds it takes to appear (up to 60): tell the person to wait that long before looking. Try list_devices with near first; use this when several screens are in one room.

Make a slideshow from a Google Slides presentation. Needs a short-lived Google access token with Drive read access to that file (from a Google sign-in you run with the drive.readonly scope); it is used for this one call and never stored. Give fileId or the presentation url. Google exports at most 10 MB. Counts against the plan's slideshow limit. Without a token, ask the person to download the presentation as PDF or PowerPoint and use upload_pptx instead.

Copy one page of a shared slideshow to the end of this slideshow. Both must come from a PowerPoint or PDF file; slideNumber must be one of the source's importableSlideNumbers from list_shared_slideshows. The copy does not change when the source does. There is no undo: remove the page with delete_slide.

Add the previews of a Ready AI slide job to the slideshow, after the person approved them. Safe to repeat: it does not add them twice. Queues a re-render.

Invite a person to this workspace by email. This is how the person gets in after you created the workspace with your own address: invite them as TenantAdmin (the default) so they can manage screens, billing and the team themselves. Other roles: ContentManager (edits content), DeviceManager (pairs screens), Viewer. The invitation expires in 7 days.

After a job went well, give your own verdict on working with InfoSlides, once per job. The team may pin it to the InfoSlides landing page, shown as a quote from '<agent>, AI agent' with the context below it as 'Job: <context>'; nothing about the workspace or the person is shown. Write it in your own words; never quote the person, and leave out personal data.

See the kinds of live content source this workspace can create (RSS feed, weather, calendar and more), with the config fields each one needs. Use before create_source, and ask the person for those settings (feed address, city, calendar link) instead of guessing them.

Audit who and what can reach this workspace: every key with its scope, when it was created, and when it was last used. Only the opening characters of each key are shown, never the whole thing. Use it to spot unused keys worth revoking, or to find the id of a key to revoke.

List the sample slide names preview_brand can draw.

See every screen registered to this workspace, the shape each one is set up for and what it is playing now (nowPlayingTitle and nowPlayingSlideshowId). This is how "the front lobby screen" becomes content you can read and edit: find the screen by name, then get_slideshow with its nowPlayingSlideshowId. Also use it to find the id of a screen before assigning content to it, or to check how many of the account's allowed screens are already used. q filters by name ("lobby" finds "Lobby Screen"). For "this screen" or "the screen in front of me", pass near with the person's position: screens with a saved location (update_device) come nearest-first with distanceMeters. supportsHtml says whether the screen's app plays HTML playback.

Browse ready-made screen designs — menu boards, welcome screens, notice layouts — that can be copied into the workspace with clone_slideshow(fromGallery=true). Start here when the user wants something on a screen quickly and has no content prepared.

Browse the workspace's media library, newest first: id, name, fileType (image, video, document), sizeBytes, width, height, folderId, shared (a file another workspace shares, which cannot be changed here), sharedWithOthers and createdAt. Filter by folder, type or name; the answer also has total, totalPages and storage used and allowed. Use an id as mediaAssetId on add_media_slide.

List every media library folder as one flat list: id, name and parentFolderId (null at the top level). Find a folder by name here, then pass its id as folderId to list_media or update_media.

List the workspace's shared slideshows with id, title, slideCount and importableSlideNumbers (the pages that can be copied), to pick a page for import_slide. excludeId leaves one out, usually the slideshow that will receive the page.

See everything this workspace can put on a screen, with the shape (landscape or portrait) each one is built for, whether its latest render has finished (renderStatus) and how many screens are playing it (screenCount). Use it to find the id of existing content before editing it or assigning it to a display; to go from a screen's name to its content, list_devices shows what each screen is playing. q filters by title ("q1" finds "Q1 Results 2026"). The answer has items and total: when total is more than the items returned, ask for the next page.

See the data sources this workspace can show on a screen: RSS news feeds, calendars, weather, live data pushed by another system. Use it to find the id of a source before scrolling its headlines in a slideshow's news ticker (update_slideshow tickerSourceIds) or pointing a live-data slide at it (update_slide sourceId). Each entry has its name, type, when it last received data and its health (Healthy, Degraded or Failing, with lastError in plain words): check it before building a slide on a source.

See which screens are showing a notice or announcement that interrupts their normal schedule for a while (a fire drill message, a launch announcement, an evacuation map), now or planned, and until when. Filter by screen, or only the active ones.

See who is in this workspace (members and their roles) and which invitations are still waiting to be accepted.

List the template category names this workspace may use, such as News or Generic: the same set that decides which built-in layouts list_templates shows.

See the self-updating screen layouts available to this workspace, each with an example of the data it expects. Check that example before pushing values with update_source, and use this to find a ready-made layout instead of building one.

AI Studio: design a slide in the workspace's style from a description (handler prompt: headline, details, prices, times), a photo of a poster, menu or whiteboard (photo: mediaAssetId from upload_media, or mediaUrl), a web page (url) or a PDF/Word file (document: mediaAssetId). Returns a job at once: poll get_ai_slide_job every 5 seconds (10 to 60 seconds). By default it stops at Ready with preview images: show them to the person, then insert_ai_slides. To show a photo as it is, use add_media_slide instead. EntitlementRequired comes with an upgrade link; trialAvailable in its details means start_ai_studio_trial is possible: ask the person first.

Connect a physical TV to this workspace. The TV shows a pairing screen (the InfoSlides TV app, or https://infoslides.app/pair.html in its browser) with a QR code and a short nickname such as swift-oak-42. If the person reads you the QR code or nickname, or you see it through their glasses, send qr or nickname plus slideshowId (a new screen playing it) or deviceId (replaces the TV on an existing screen). With neither, the error is NeedsClarification with the workspace's slideshows and screens as choices: call again with the chosen id. With nothing to scan, send deviceId alone: you get a 6-character code for the person to type on the TV before it expires. For live pushed data (HTML playback), prefer the browser page: only the browser and the Android app 1.2.0+ play HTML for now.

"Play my Q1 slides on the lobby screen" in one call. Checks that the slideshow has rendered, whether the screen is online and what it plays now, then does it. Without deviceId it picks the only screen, or the one already playing the slideshow; otherwise the error is NeedsClarification listing the screens to choose from. With until, it plays as a temporary takeover and the normal schedule returns afterwards; without it, it replaces the screen's default content. Use dryRun to tell the person what would happen first.

See a sample slide drawn from the brand guide as an image, so the person and you can check how it looks before it is confirmed. Samples: title, text, data, image, logo-light, logo-dark, ticker, clock. Shows the draft by default; source 'confirmed' shows what slides use now. Rate limited.

See what a template design looks like as an image before saving it with create_template. Give the layout HTML and CSS and sample data; nothing is saved. Rate limited.

See exactly what a slide will look like on the screen, as a PNG image, before the public does. Worth doing whenever text might overflow, a logo might sit badly, or live data has just been pushed — a mistake on a lobby display is visible to every person walking past.

Send new data to a push source: the whole set of values the slide shows, as one JSON object with the template's field names. Every slide on the source updates, and a slide that was hidden waiting for data appears. Returns receivedAt. A push-only (isk_dp_) key bound to the source can call this, so hand that key to the system that sends the data. Set dryRun=true to check the data without storing it.

Turn a team member's access back on. Fails with EntitlementRequired when the plan's user limit is reached. Workspace admins only.

Redraw the gallery picture of a layout the workspace owns, for example after its look changed. Returns thumbnailPath. Rate limited.

Remove a person from this workspace (ids from list_team). Confirm with the person first.

Rename a folder in the media library (the place photos and videos are kept).

Swap the PowerPoint or PDF behind an existing slideshow for a new version, so "replace the lobby presentation with this new PowerPoint" keeps the same slideshow, the same screens and the same schedule. Photos, videos and live-data slides the slideshow already has are kept. Read it back with get_slideshow to check the pages. The screen updates once the re-render finishes (renderStatus: Completed).

Tell the InfoSlides team you could not do what the person asked because of InfoSlides itself: no tool for it, an error you could not get past, or docs that led you wrong. The team reads every report. Leave out personal data. Then tell the person plainly what you could not do; do not retry the same failing call in a loop. At most 50 reports and testimonials per workspace a day.

Send the owner's confirmation email again. Use this when another tool fails with EmailNotVerified — the owner has to click the link in that email before screens can be registered. Tell the user to check their spam folder.

Bring back a deleted slideshow with its slides and settings. Its schedules and the screens that played it are not brought back, so assign it to a screen again. Find the id with get_audit_trail (action SlideshowDeleted, entityId). Deleted slideshows are removed for good after 90 days. Fails when the plan's slideshow limit is full.

Cut off a credential immediately — a leaked key, a system being decommissioned, someone who has left. Takes effect at once and cannot be undone; anything still using that key stops working, so confirm with the user before revoking.

Cancel a pending invitation (ids from list_team) so its link stops working.

Search the InfoSlides help articles, blog posts and release notes. Search here before telling the person something cannot be done. Also finds news since a date (since) or the notes of one release (releaseVersion). Each item has type, title, slug, url (the public page), publishedAt, releaseVersion, appRoute (the page in the InfoSlides web app the article is about) and a short excerpt. Read a whole article with get_article.

Search free stock photos (Unsplash) for a text slide background, 9 a page. Show the person thumbUrl with the photographer credit (photographerName, photographerProfileUrl, unsplashPhotoUrl) beside it: the credit must be visible whenever a photo is shown. To use one, pass the whole result as stockPhoto to add_designed_slide or in the design for update_slide_design; that is the only way to use a stock photo. Rate limited to 30 searches a minute.

Stop or restart the "screen went offline" emails for one screen, e.g. a TV that is switched off on purpose, and optionally give it its own quiet hours. This replaces the screen's settings, so send enabled every time; without quiet hours the workspace's apply.

Make a slide appear only at the right moment, or vanish at one, like the breakfast menu before 11, the weekend offer on Saturday and Sunday, the Christmas slide only in December, a 'target hit' message only when the number is actually hit. Types: 'time' (e.g. '08:00-11:00'), 'weekday' (e.g. 'sat,sun'), 'date' (e.g. '2026-12-01..2026-12-26'; either end may be left out), 'data_trigger' (e.g. 'sales_today > 1000000'). By default the slide is shown only while ALL the conditions hold; match='any' shows it while at least one does, and mode='hide' turns the rule around so the slide is hidden while they hold. Checked server-side as the stream renders; an empty list clears the slide's rule. get_slideshow reads every rule back; ones marked readOnly were set on the web page and are not replaced by this call. To hide a slide unconditionally use update_slide.

"Don't email me about screens at night." Sets the quiet hours for offline alert emails (alerts wait until they end). Give quietStart and quietEnd; give neither to alert at any hour. Screens with their own quiet hours keep them. Workspace admins only.