The Stormboard connector lets your AI agent act in each user's Stormboard account. Each user connects their own Stormboard API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 50 tools.
- Tools
- 50
- What they doRead · write · destructive
- 19 · 25 · 619 read25 write6 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Stormboard connection
In AgentKit > Connections, create a Stormboard connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'stormboard'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Stormboard:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'stormboard_auth_test',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "stormboard"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Stormboard:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="stormboard_auth_test",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Stormboard credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolstormboard_auth_testCheck that the API key works.Read-onlyTest Authentication
Check that the API key works. Returns 200 when it is valid and 403 when it is not.
Inputs
This tool takes no inputs.
stormboard_idea_comments_listList the comments on an idea, oldest or newest first, optionally with an avatar map.Read-onlyList Idea Comments
List the comments on an idea, oldest or newest first, optionally with an avatar map. Returns comments with author, text and time.
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
avatarsinteger- 1 to include a map of user avatars, 0 to leave it out. Example: 0.one of
01 orderstring- Sort order. Defaults to asc. Example: asc.one of
ascdesc
stormboard_idea_getGet one idea with its data and metadata: type, text or file data, color, shape, position, votes, comments count and task.Read-onlyGet Idea
Get one idea with its data and metadata: type, text or file data, color, shape, position, votes, comments count and task. Returns the idea object.
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_storm_access_getCheck whether you can access a Storm and with which role.Read-onlyGet My Storm Access
Check whether you can access a Storm and with which role. Returns your access level, or 401 when you have no access.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_chat_messages_listList the chat messages in a Storm.Read-onlyList Storm Chat Messages
List the chat messages in a Storm. Returns messages with author, text and time. Use stormboard_storm_chat_unread_list for only unread ones.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_chat_unread_listList the chat messages in a Storm you have not read yet.Read-onlyList Unread Storm Chat Messages
List the chat messages in a Storm you have not read yet. Returns messages. Mark them read with stormboard_storm_chat_mark_read.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_connectors_listList the line connectors between ideas in a Storm.Read-onlyList Storm Connectors
List the line connectors between ideas in a Storm. Returns connector IDs with their from and to ideas, label and color.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_getGet a Storm's details and setup: title, description, owner, plan, votes per user, legend and status.Read-onlyGet Storm
Get a Storm's details and setup: title, description, owner, plan, votes per user, legend and status. Returns the Storm object.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_ideas_listList the ideas (sticky notes) in a Storm, optionally only those modified since a time.Read-onlyList Storm Ideas
List the ideas (sticky notes) in a Storm, optionally only those modified since a time. Returns ideas with text, color, position, votes and section; files, images and whiteboards need stormboard_idea_get for their data.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
last_modified_minstring- Only ideas modified since this ISO 8601 time. Example: 2026-01-15T00:00:00Z.
stormboard_storm_invites_listList the Storms you have been invited to but not joined, optionally by team or title text.Read-onlyList Storm Invites
List the Storms you have been invited to but not joined, optionally by team or title text. Returns invites. Accept with stormboard_storm_invite_accept.
Inputs
needlestring- Only Storms whose title contains this text. Example: Planning.
teaminteger- Only invites for this team ID. Example: 1234.
stormboard_storm_participants_listList the participants of a Storm with their roles.Read-onlyList Storm Participants
List the participants of a Storm with their roles. Returns users with IDs, names and roles. Use the IDs as assigned_to in stormboard_idea_task_update.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_template_getGet the template layout of a Storm: its sections and subsections with titles and indexes.Read-onlyGet Storm Template
Get the template layout of a Storm: its sections and subsections with titles and indexes. Returns the sections. Use a section index with stormboard_idea_create and stormboard_storm_section_update.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storms_listList the Storms (boards) you can access, optionally by team, folder, title text or status, with sorting and paging.Read-onlyList Storms
List the Storms (boards) you can access, optionally by team, folder, title text or status, with sorting and paging. Returns Storm IDs, titles, owners and activity. Use stormboard_storm_get for one Storm.
Inputs
folderinteger- Only Storms in this dashboard folder ID, from stormboard_team_folders_list. Example: 5678.
needlestring- Only Storms whose title contains this text. Example: Retrospective.
orderstring- Sort order: activity (last active), alpha (A to Z), frequency (most accessed) or starred. Example: activity.one of
activityalphafrequencystarred resultsinteger- Number of results, up to 100. Defaults to 50. Example: 50.
startinteger- Index to start the list at, for paging. Example: 0.
statusstring- Only open or closed Storms. Example: open.one of
openclosed teaminteger- Only Storms of this team ID. Example: 1234.
stormboard_team_folders_listList the dashboard folders of a team.Read-onlyList Team Folders
List the dashboard folders of a team. Returns folder IDs and names. Use a folder ID to filter stormboard_storms_list.
Inputs
team_idintegerrequired- Team ID, from the team field of stormboard_storms_list or your Stormboard team settings. Example: 1234.
stormboard_template_categories_listList the categories of Storm templates.Read-onlyList Template Categories
List the categories of Storm templates. Returns category IDs and names. Use an ID with stormboard_templates_list.
Inputs
This tool takes no inputs.
stormboard_templates_listList the Storm templates in a category (for example retrospective, SWOT or kanban boards).Read-onlyList Templates
List the Storm templates in a category (for example retrospective, SWOT or kanban boards). Returns template IDs, names and previews. Pass a template ID to stormboard_storm_create.
Inputs
categoryintegerrequired- Template category ID, from stormboard_template_categories_list. Example: 3.
stormboard_user_profile_getGet the profile of the user who owns the API key: name, email, username and plan.Read-onlyGet My Profile
Get the profile of the user who owns the API key: name, email, username and plan. Returns the user object.
Inputs
This tool takes no inputs.
stormboard_connector_createDraw a line connector between two ideas, with an optional label, color and arrowheads.WriteCreate Connector
Draw a line connector between two ideas, with an optional label, color and arrowheads. Returns the new connector ID.
Inputs
from_idea_idintegerrequired- ID of the idea the line starts from. Example: 1000000.
to_idea_idintegerrequired- ID of the idea the line ends at. Example: 1000001.
colorstring- Line color. Defaults to default. Example: pink.one of
defaultyellowlight-orangeorangeredlight-greengreentealturquoiselight-bluebluepurpledark-purplebrownpinkgreyblack from_end_typestring- Arrowhead at the source end; empty for none. Example: arrow.one of
arrow labelstring- Label on the line. Example: Depends on.
to_end_typestring- Arrowhead at the target end. Defaults to arrow. Example: arrow.one of
arrow
stormboard_connector_updateChange a line connector's label, color or arrowheads.WriteUpdate Connector
Change a line connector's label, color or arrowheads. Returns the result. Get connector IDs from stormboard_storm_connectors_list.
- Idempotent
Inputs
connector_idintegerrequired- Connector ID, from stormboard_storm_connectors_list. Example: 88001.
colorstring- New line color. Example: red.one of
defaultyellowlight-orangeorangeredlight-greengreentealturquoiselight-bluebluepurpledark-purplebrownpinkgreyblack from_end_typestring- Arrowhead at the source end. Example: arrow.one of
arrow labelstring- New label. Example: Blocks.
to_end_typestring- Arrowhead at the target end. Example: arrow.one of
arrow
stormboard_idea_comment_createPost a comment on an idea.WriteAdd Idea Comment
Post a comment on an idea. Returns the new comment ID.
Inputs
commentstringrequired- Text of the comment. Example: Can we split this into two tasks?.
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_idea_comment_updateEdit one of your comments on an idea.WriteUpdate Idea Comment
Edit one of your comments on an idea. Returns the result.
- Idempotent
Inputs
commentstringrequired- New text of the comment. Example: Split into two tasks: data and UI.
comment_idintegerrequired- Comment ID, from stormboard_idea_comments_list. Example: 77001.
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_idea_createAdd an idea (sticky note) to a Storm: text, index card, image, video, document or whiteboard, with color, shape and position or a template section.WriteCreate Idea
Add an idea (sticky note) to a Storm: text, index card, image, video, document or whiteboard, with color, shape and position or a template section. Returns the new idea ID. Images and documents are sent as base64 data.
Inputs
datastringrequired- Content: text, a video URL, or base64 image or document data. Example: Automate the weekly report.
stormidintegerrequired- Storm ID, from stormboard_storms_list. Example: 49999.
colorstring- Idea color. Defaults to yellow. Example: yellow.one of
yellowlight-orangeorangeredlight-greengreentealturquoiselight-bluebluelight-purplepurplebrownlight-pinkpinkgrey lockinteger- 1 to lock the idea, 0 to leave it unlocked. Example: 0.one of
01 namestring- File name for images and documents (with extension), or the name of a video or whiteboard. Example: roadmap.pdf.
sectionindexstring- Template section index to place the idea in; overrides x and y. From stormboard_storm_template_get. Example: 2.
shapestring- Idea shape. Defaults to standard. Example: standard.one of
standardgemhexagonoctagonsquaretitletriangle typestring- Idea type. Defaults to text. Example: text.one of
textindexcardimagevideodocumentwhiteboard xinteger- X position on the board. Example: 400.
yinteger- Y position on the board. Example: 250.
stormboard_idea_task_updateTurn an idea into a task or update it: assignee, due date and completion date, optionally notifying the assignee.WriteUpdate Idea Task
Turn an idea into a task or update it: assignee, due date and completion date, optionally notifying the assignee. Returns the result.
- Idempotent
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
assigned_tointeger- Stormboard user ID of the assignee, from stormboard_storm_participants_list. Example: 556677.
date_completedstring- Completion date (YYYY-MM-DD). Example: 2026-02-12.
date_duestring- Due date (YYYY-MM-DD). Example: 2026-02-15.
notifyinteger- 1 to send the assignee an email or push notification (default), 0 to skip. Example: 1.one of
01
stormboard_idea_updateChange an idea's content, type, color, shape, position or lock.WriteUpdate Idea
Change an idea's content, type, color, shape, position or lock. Returns the result.
- Idempotent
Inputs
datastringrequired- New content: text, a video URL, or base64 image, whiteboard or document data. Example: Automate the weekly report (owner: Ana)
idea_idintegerrequired- Idea ID, from stormboard_storm_ideas_list. Example: 1000000.
colorstring- New color. Example: green.one of
yellowlight-orangeorangeredlight-greengreentealturquoiselight-bluebluelight-purplepurplebrownlight-pinkpinkgrey lockinteger- 1 to lock, 0 to unlock. Example: 1.one of
01 shapestring- New shape. Example: hexagon.one of
standardgemhexagonoctagonsquaretitletriangle typestring- Idea type. Defaults to text. Example: text.one of
texttitleimagevideodocumentwhiteboard xinteger- New X position. Example: 420.
yinteger- New Y position. Example: 260.
stormboard_idea_vote_addCast one of your votes on an idea.WriteVote for Idea
Cast one of your votes on an idea. Returns the result. Each participant has a limited number of votes per Storm.
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_idea_vote_removeTake back your vote from an idea.WriteRemove Idea Vote
Take back your vote from an idea. Returns the result.
- Idempotent
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_storm_chat_mark_readMark every chat message in a Storm as read for you.WriteMark Storm Chat as Read
Mark every chat message in a Storm as read for you. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_chat_message_sendPost a chat message to a Storm's chat for all participants.WriteSend Storm Chat Message
Post a chat message to a Storm's chat for all participants. Returns the new message.
Inputs
messagestringrequired- Text of the chat message. Example: Let's vote on the top three ideas by Friday.
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_createCreate a Storm (board) under a personal, student, educator or team plan, optionally from a template.WriteCreate Storm
Create a Storm (board) under a personal, student, educator or team plan, optionally from a template. Returns the new Storm with its ID and key.
Inputs
planstringrequired- Plan to create the Storm under; team needs team_id. Example: personal.one of
personalstudenteducatorteam titlestringrequired- Title of the Storm, up to 100 characters. Example: Q1 Product Retrospective.
avatarsinteger- 1 to show participants' avatars where they are on the board, 0 to hide. Example: 1.one of
01 descriptionstring- Description or goals of the Storm. Example: What went well, what didn't, and what we'll change.
ideacreatorinteger- 1 to show the creator's avatar on each idea, 0 to hide. Example: 1.one of
01 team_idinteger- Team ID; required when plan is team. Example: 1234.
templateinteger- Template ID, from stormboard_templates_list. Example: 12.
votesperuserinteger- Votes each participant gets, 0 to 100. Defaults to 10. Example: 5.
stormboard_storm_duplicateCopy a Storm with its ideas into a new Storm.WriteDuplicate Storm
Copy a Storm with its ideas into a new Storm. Returns the new Storm.
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormnamestring- Name of the copy; defaults to the original name plus - Duplicate. Example: Q2 Retrospective.
stormboard_storm_favorite_addStar a Storm as a favorite on your dashboard.WriteStar Storm
Star a Storm as a favorite on your dashboard. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_favorite_removeRemove the favorite star from a Storm.WriteUnstar Storm
Remove the favorite star from a Storm. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_inviteInvite people by email to a Storm as contributors or viewers, with an optional message.WriteInvite to Storm
Invite people by email to a Storm as contributors or viewers, with an optional message. Stormboard emails them. Returns the result.
Inputs
participantsarrayrequired- Email addresses to invite. Example: ["ana@example.com", "lee@example.com"]
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
messagestring- Message included in the invitation. Example: Join our retro board before Friday.
typestring- Permission of the invitees. Defaults to contributor. Example: contributor.one of
contributorviewer
stormboard_storm_invite_acceptAccept an invitation to a Storm so it appears on your dashboard.WriteAccept Storm Invite
Accept an invitation to a Storm so it appears on your dashboard. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_joinJoin a Storm with its ID and private Storm key from the share dialog.WriteJoin Storm
Join a Storm with its ID and private Storm key from the share dialog. Returns the result.
- Idempotent
Inputs
stormidintegerrequired- Storm ID from the share dialog. Example: 49999.
stormkeystringrequired- Private Storm key from the share dialog. Example: piece335.
stormboard_storm_legend_updateSet the labels of the Storm's color legend, for example yellow = Ideas, pink = Risks.WriteUpdate Storm Legend
Set the labels of the Storm's color legend, for example yellow = Ideas, pink = Risks. Returns the result.
- Idempotent
Inputs
colorobjectrequired- Map of color names to labels; colors: yellow, light-orange, orange, red, light-green, green, teal, turquoise, light-blue, blue, light-purple, purple, brown, light-pink, pink, grey. Example: {"yellow": "Ideas", "pink": "Risks"}
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_reopenReopen a closed Storm.WriteReopen Storm
Reopen a closed Storm. Returns the result. You must be a Storm administrator or the team owner.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_section_updateChange a template section's title, description or one-to-two-character marker in a Storm.WriteUpdate Storm Section
Change a template section's title, description or one-to-two-character marker in a Storm. Returns the result. Get section indexes from stormboard_storm_template_get.
- Idempotent
Inputs
section_indexintegerrequired- Index of the section, from stormboard_storm_template_get. Example: 2.
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
characterstring- New section marker, up to 2 characters. Example: 1.
descriptionstring- New section description. Example: Wins from this quarter.
namestring- New section title. Example: What went well.
stormboard_storm_tag_createCreate a tag (a custom field) in a Storm, without values on any idea.WriteCreate Storm Tag
Create a tag (a custom field) in a Storm, without values on any idea. Returns the result. Set values with stormboard_idea_tags_set.
Inputs
namestringrequired- Tag name, 1 to 40 characters, not starting with a number or underscore. Example: Owner.
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_updateUpdate a Storm's title, description, template, votes per user or avatar settings.WriteUpdate Storm
Update a Storm's title, description, template, votes per user or avatar settings. Returns the result. You must be the Storm creator or an administrator.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
avatarsinteger- 1 to show participants' avatars, 0 to hide. Example: 1.one of
01 descriptionstring- New description or goals. Example: Agree on three actions.
ideacreatorinteger- 1 to show the creator's avatar on each idea, 0 to hide. Example: 0.one of
01 templateinteger- Template ID, from stormboard_templates_list. Example: 12.
titlestring- New title, up to 100 characters. Example: Q1 Retrospective (final)
votesperuserinteger- Votes each participant gets, 0 to 100. Example: 3.
stormboard_user_notifications_updateTurn your daily activity email, the monthly newsletter and new-participant notifications on or off.WriteUpdate My Notifications
Turn your daily activity email, the monthly newsletter and new-participant notifications on or off. Returns the result.
- Idempotent
Inputs
dailyemailinteger- 1 to receive the daily activity email, 0 to stop it. Example: 1.one of
01 newsletterinteger- 1 to receive the monthly newsletter, 0 to stop it. Example: 0.one of
01 newstormuserinteger- 1 to be told when someone joins one of your Storms, 0 to stop it. Example: 1.one of
01
stormboard_connector_deleteDelete a line connector by ID.DestructiveDelete Connector
Delete a line connector by ID. Returns the result.
- Idempotent
Inputs
connector_idintegerrequired- Connector ID, from stormboard_storm_connectors_list. Example: 88001.
stormboard_idea_comment_deleteDelete one of your comments on an idea.DestructiveDelete Idea Comment
Delete one of your comments on an idea. Returns the result.
- Idempotent
Inputs
comment_idintegerrequired- Comment ID, from stormboard_idea_comments_list. Example: 77001.
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_idea_deleteDelete an idea from its Storm.DestructiveDelete Idea
Delete an idea from its Storm. Returns the result.
- Idempotent
Inputs
idea_idintegerrequired- Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
stormboard_storm_closeClose an open Storm so participants can no longer change it.DestructiveClose Storm
Close an open Storm so participants can no longer change it. Returns the result. Reopen it with stormboard_storm_reopen.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_invite_declineDecline an invitation to a Storm and remove it from your list.DestructiveDecline Storm Invite
Decline an invitation to a Storm and remove it from your list. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
stormboard_storm_leaveLeave a Storm so it is removed from your dashboard.DestructiveLeave Storm
Leave a Storm so it is removed from your dashboard. Returns the result.
- Idempotent
Inputs
storm_idintegerrequired- Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
No tools match.