---
title: "Sideshow integration for LuumenAI"
url: "https://www.luumen.ai/integrations/sideshow/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Sideshow integration for LuumenAI

Read Sideshow sessions and posts, then publish or update surfaces on approval

## What LuumenAI can do with Sideshow

LuumenAI connects to Sideshow with an API token and exposes 10 tools (5 read-only · 3 write · 2 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 10 tools (5 read-only · 3 write · 2 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About Sideshow with LuumenAI

Connect Sideshow and Luumen can read your workspace the way a teammate would: which sessions exist, what was posted recently, the current surface content of a post and its retained versions, and the comment thread around it. When something needs to change, the agent drafts the post or update, shows you the surfaces it intends to write, and waits for your approval before publishing. Authentication is by API key.

## Example tools

Read-only (5 in total):

- `SIDESHOW_GET_POST` — Get one post with current surface content and retained version history.
- `SIDESHOW_LIST_COMMENTS` — List currently available comments, optionally filtered by session, post, author, or sequence number.
- `SIDESHOW_LIST_KITS` — List the HTML style and behavior kits available to use in post surfaces.
- `SIDESHOW_LIST_POSTS` — List compact post summaries from one session, or the most recently updated posts across the workspace when session_id is omitted.
- `SIDESHOW_LIST_SESSIONS` — List workspace sessions with their post and surface counts so a session can be selected for publishing or post filtering.

Write and destructive (5 in total, subject to configured approval policy):

- `SIDESHOW_CREATE_COMMENT` — Create a text comment attached to a post.
- `SIDESHOW_DELETE_COMMENT` — Permanently delete one comment by id.
- `SIDESHOW_DELETE_POST` — Permanently delete one post by id.
- `SIDESHOW_PUBLISH_POST` — Publish a post with one or more ordered typed surfaces, using an existing session or automatically creating one when session_id is omitted.
- `SIDESHOW_UPDATE_POST` — Update a post title and/or the primary content of one surface while preserving that surface's kind and metadata; creates a retained version.

## Frequently asked questions

### How does LuumenAI connect to Sideshow?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Sideshow on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Sideshow — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/sideshow/