18 available actions
What your AI agent can do in Sideshow
Publish agent-generated visual surfaces — diagrams, code, markdown, images — as shareable posts. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 18 actions.
Common starting points
- Get design guideFetch HTML fragment, sizing, theme, kit, CDN, and interactivity guidance.
- Get postGet one full post with surface ids/indexes, version, and history; use before targeted edits or after compaction.
- Add surfaceInsert one publish_post-shaped surface into a post; before/after accepts an id or 0-based index.
- Send test postPublish the idempotent built-in welcome post to test a connection or fresh workspace; returns the existing post if already sent.
- Update postRevise a post in place instead of publishing a duplicate.
- Update snippetDeprecated HTML-only update_post sugar.
Browse all 18 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 4 actions
- Get design guideFetch HTML fragment, sizing, theme, kit, CDN, and interactivity guidance.
- Get postGet one full post with surface ids/indexes, version, and history; use before targeted edits or after compaction.
- List postsList posts, optionally scoped by session.
- List surfacesDeprecated list_posts alias.
Create & communicateCreate records or send supported messagesView 6 actions
- Add surfaceInsert one publish_post-shaped surface into a post; before/after accepts an id or 0-based index.
- Publish postPublish ordered surfaces as one post.
- Publish snippetDeprecated HTML-only publish_post sugar.
- Publish surfaceDeprecated publish_post alias; pass the same surface shape as parts.
- Send test postPublish the idempotent built-in welcome post to test a connection or fresh workspace; returns the existing post if already sent.
- Upload assetUpload base64 bytes and return id and URL.
Update & manageChange and manage existing recordsView 4 actions
- Edit surfaceReplace one surface by id/index, or pass content to preserve its kind-specific options.
- Update postRevise a post in place instead of publishing a duplicate.
- Update snippetDeprecated HTML-only update_post sugar.
- Update surfaceDeprecated update_post alias; pass replacement surfaces as parts.
Remove & cancelRemove records or cancel supported workView 1 action
- Remove surfaceRemove one surface by id/index; a post must retain at least one.
Other actionsSpecialist and administrative actions.View 3 actions
- Reorder surfacesReorder every surface using ids or 0-based indexes; order length must match.
- Reply to userPost a short plain-text reply using postId (surfaceId is deprecated).
- Wait for feedbackWait up to 300 seconds for comments not yet delivered on any channel; 0 is a non-blocking check.
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Sideshow account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Sideshow
How does the agent connect to Sideshow?
You sign in with your own Sideshow account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Sideshow at any time.
What can the agent actually do in Sideshow?
The page above lists the 18 actions currently available through the Sideshow connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Sideshow included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Sideshow is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Sideshow to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.