Skip to main content
Sideshow logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: SIDESHOW
  • Version: 20261101_00

Tools

Slug: SIDESHOW_CREATE_COMMENTCreate a text comment attached to a post.

Input Parameters

string
required
Comment text. Leading and trailing whitespace is removed.
string
Author label recorded on the comment. Omit it to let Sideshow derive the label from the connected session. Do not send ‘user’ or ‘surface’: Sideshow reserves those for real viewer input and routes ‘user’ comments into the session’s feedback stream.
string
required
Post ID to comment on.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_DELETE_COMMENTPermanently delete one comment by id.

Input Parameters

string
required
Comment id to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_DELETE_POSTPermanently delete one post by id.

Input Parameters

string
required
Post id to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_GET_POSTGet one post with current surface content and retained version history.

Input Parameters

string
required
Post id returned by LIST_POSTS or PUBLISH_POST.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_LIST_COMMENTSList currently available comments, optionally filtered by session, post, author, or sequence number. This call never long-polls.

Input Parameters

string
Return comments by this author only.
string
Return comments attached to this post only.
string
Return comments from this session only.
integer
Return comments after this sequence number. Pass the prior last_sequence value for an incremental read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_LIST_KITSList the HTML style and behavior kits available to use in post surfaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_LIST_POSTSList compact post summaries from one session, or the most recently updated posts across the workspace when session_id is omitted.

Input Parameters

integer
Maximum recent posts to return when session_id is omitted.
string
Session to list. Omit to list recent posts across the workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_LIST_SESSIONSList workspace sessions with their post and surface counts so a session can be selected for publishing or post filtering.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_PUBLISH_POSTPublish a post with one or more ordered typed surfaces, using an existing session or automatically creating one when session_id is omitted.

Input Parameters

string
Agent label recorded on an automatically created session.
string
Post title.
array
required
Ordered content surfaces. Each item must select exactly one schema with kind: html, markdown, mermaid, diff, image, trace, terminal, json, or code.
string
Existing session ID. Omit to create a session automatically.
string
Title for the automatically created session; use only without session_id.
string
Working-directory context recorded on an automatically created session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SIDESHOW_UPDATE_POSTUpdate a post title and/or the primary content of one surface while preserving its kind; HTML kit IDs can also be replaced. The update creates a retained version.

Input Parameters

array
Replacement HTML kit IDs. Use only when updating HTML content.
string
Replacement post title.
string
Replacement primary content for the selected surface, such as Markdown, code, HTML, or terminal text.
string
required
Post ID to update.
string
Surface ID or zero-based index. Required for a multi-surface post when content is set; omit only to use the upstream single-surface default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not