> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Stormboard

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.

**Authentication:** API Key
**Categories:** Collaboration, Productivity
**Tools:** 50: 19 read, 25 write, 6 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=STORMBOARD)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Stormboard connection

   In **AgentKit > Connections**, create a Stormboard connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'stormboard'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'stormboard_auth_test',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "stormboard"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="stormboard_auth_test",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Stormboard credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'stormboard_auth_test',
  toolInput: {},
  connector: 'stormboard',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="stormboard_auth_test",
    tool_input={},
    connection_name="stormboard",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `stormboard_auth_test`

Test Authentication · Read-only

Check that the API key works. Returns 200 when it is valid and 403 when it is not.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `stormboard_idea_comments_list`

List Idea Comments · Read-only

List the comments on an idea, oldest or newest first, optionally with an avatar map. Returns comments with author, text and time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
- `avatars` (`integer`, optional): 1 to include a map of user avatars, 0 to leave it out. Example: 0. One of: `0`, `1`.
- `order` (`string`, optional): Sort order. Defaults to asc. Example: asc. One of: `asc`, `desc`.

Example input: `{"idea_id":1000000}`

### `stormboard_idea_get`

Get Idea · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"idea_id":1000000}`

### `stormboard_idea_tags_get`

Get Idea Tags · Read-only

Get the tag values set on an idea. Returns tag name/value pairs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"idea_id":1000000}`

### `stormboard_storm_access_get`

Get My Storm Access · Read-only

Check whether you can access a Storm and with which role. Returns your access level, or 401 when you have no access.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_chat_messages_list`

List Storm Chat Messages · Read-only

List the chat messages in a Storm. Returns messages with author, text and time. Use stormboard_storm_chat_unread_list for only unread ones.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_chat_unread_list`

List Unread Storm Chat Messages · Read-only

List the chat messages in a Storm you have not read yet. Returns messages. Mark them read with stormboard_storm_chat_mark_read.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_connectors_list`

List Storm Connectors · Read-only

List the line connectors between ideas in a Storm. Returns connector IDs with their from and to ideas, label and color.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_get`

Get Storm · Read-only

Get a Storm's details and setup: title, description, owner, plan, votes per user, legend and status. Returns the Storm object.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_ideas_list`

List Storm Ideas · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
- `last_modified_min` (`string`, optional): Only ideas modified since this ISO 8601 time. Example: 2026-01-15T00:00:00Z.

Example input: `{"storm_id":49999}`

### `stormboard_storm_invites_list`

List Storm Invites · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `needle` (`string`, optional): Only Storms whose title contains this text. Example: Planning.
- `team` (`integer`, optional): Only invites for this team ID. Example: 1234.

Example input: `{}`

### `stormboard_storm_participants_list`

List Storm Participants · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_tags_list`

List Storm Tags · Read-only

List the tags defined in a Storm. Returns tag names. Per-idea values come from stormboard_idea_tags_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_template_get`

Get Storm Template · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storms_list`

List Storms · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder` (`integer`, optional): Only Storms in this dashboard folder ID, from stormboard_team_folders_list. Example: 5678.
- `needle` (`string`, optional): Only Storms whose title contains this text. Example: Retrospective.
- `order` (`string`, optional): Sort order: activity (last active), alpha (A to Z), frequency (most accessed) or starred. Example: activity. One of: `activity`, `alpha`, `frequency`, `starred`.
- `results` (`integer`, optional): Number of results, up to 100. Defaults to 50. Example: 50.
- `start` (`integer`, optional): Index to start the list at, for paging. Example: 0.
- `status` (`string`, optional): Only open or closed Storms. Example: open. One of: `open`, `closed`.
- `team` (`integer`, optional): Only Storms of this team ID. Example: 1234.

Example input: `{}`

### `stormboard_team_folders_list`

List Team Folders · Read-only

List the dashboard folders of a team. Returns folder IDs and names. Use a folder ID to filter stormboard_storms_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`integer`, required): Team ID, from the team field of stormboard_storms_list or your Stormboard team settings. Example: 1234.

Example input: `{"team_id":1234}`

### `stormboard_template_categories_list`

List Template Categories · Read-only

List the categories of Storm templates. Returns category IDs and names. Use an ID with stormboard_templates_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `stormboard_templates_list`

List Templates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category` (`integer`, required): Template category ID, from stormboard_template_categories_list. Example: 3.

Example input: `{"category":3}`

### `stormboard_user_profile_get`

Get My Profile · Read-only

Get the profile of the user who owns the API key: name, email, username and plan. Returns the user object.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `stormboard_connector_create`

Create Connector · Write

Draw a line connector between two ideas, with an optional label, color and arrowheads. Returns the new connector ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from_idea_id` (`integer`, required): ID of the idea the line starts from. Example: 1000000.
- `to_idea_id` (`integer`, required): ID of the idea the line ends at. Example: 1000001.
- `color` (`string`, optional): Line color. Defaults to default. Example: pink. One of: `default`, `yellow`, `light-orange`, `orange`, `red`, `light-green`, `green`, `teal`, `turquoise`, `light-blue`, `blue`, `purple`, `dark-purple`, `brown`, `pink`, `grey`, `black`.
- `from_end_type` (`string`, optional): Arrowhead at the source end; empty for none. Example: arrow. One of: `arrow`.
- `label` (`string`, optional): Label on the line. Example: Depends on.
- `to_end_type` (`string`, optional): Arrowhead at the target end. Defaults to arrow. Example: arrow. One of: `arrow`.

Example input: `{"from_idea_id":1000000,"to_idea_id":1000001}`

### `stormboard_connector_update`

Update Connector · Write

Change a line connector's label, color or arrowheads. Returns the result. Get connector IDs from stormboard_storm_connectors_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `connector_id` (`integer`, required): Connector ID, from stormboard_storm_connectors_list. Example: 88001.
- `color` (`string`, optional): New line color. Example: red. One of: `default`, `yellow`, `light-orange`, `orange`, `red`, `light-green`, `green`, `teal`, `turquoise`, `light-blue`, `blue`, `purple`, `dark-purple`, `brown`, `pink`, `grey`, `black`.
- `from_end_type` (`string`, optional): Arrowhead at the source end. Example: arrow. One of: `arrow`.
- `label` (`string`, optional): New label. Example: Blocks.
- `to_end_type` (`string`, optional): Arrowhead at the target end. Example: arrow. One of: `arrow`.

Example input: `{"connector_id":88001}`

### `stormboard_idea_comment_create`

Add Idea Comment · Write

Post a comment on an idea. Returns the new comment ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `comment` (`string`, required): Text of the comment. Example: Can we split this into two tasks?.
- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"comment":"<comment>","idea_id":1000000}`

### `stormboard_idea_comment_update`

Update Idea Comment · Write

Edit one of your comments on an idea. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `comment` (`string`, required): New text of the comment. Example: Split into two tasks: data and UI.
- `comment_id` (`integer`, required): Comment ID, from stormboard_idea_comments_list. Example: 77001.
- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"comment":"<comment>","comment_id":77001,"idea_id":1000000}`

### `stormboard_idea_create`

Create Idea · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `data` (`string`, required): Content: text, a video URL, or base64 image or document data. Example: Automate the weekly report.
- `stormid` (`integer`, required): Storm ID, from stormboard_storms_list. Example: 49999.
- `color` (`string`, optional): Idea color. Defaults to yellow. Example: yellow. One of: `yellow`, `light-orange`, `orange`, `red`, `light-green`, `green`, `teal`, `turquoise`, `light-blue`, `blue`, `light-purple`, `purple`, `brown`, `light-pink`, `pink`, `grey`.
- `lock` (`integer`, optional): 1 to lock the idea, 0 to leave it unlocked. Example: 0. One of: `0`, `1`.
- `name` (`string`, optional): File name for images and documents (with extension), or the name of a video or whiteboard. Example: roadmap.pdf.
- `sectionindex` (`string`, optional): Template section index to place the idea in; overrides x and y. From stormboard_storm_template_get. Example: 2.
- `shape` (`string`, optional): Idea shape. Defaults to standard. Example: standard. One of: `standard`, `gem`, `hexagon`, `octagon`, `square`, `title`, `triangle`.
- `type` (`string`, optional): Idea type. Defaults to text. Example: text. One of: `text`, `indexcard`, `image`, `video`, `document`, `whiteboard`.
- `x` (`integer`, optional): X position on the board. Example: 400.
- `y` (`integer`, optional): Y position on the board. Example: 250.

Example input: `{"data":"<data>","stormid":49999}`

### `stormboard_idea_tags_set`

Set Idea Tags · Write

Set tag values on an idea; tags not listed keep their values and unknown tags are created in the Storm. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data` (`object`, required): Tag values as name/value pairs. Example: {"Owner": "John Smith", "Integration ID": "e65561b7"}
- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"data":{"Owner":"John Smith","Integration ID":"e65561b7"},"idea_id":1000000}`

### `stormboard_idea_task_update`

Update Idea Task · Write

Turn an idea into a task or update it: assignee, due date and completion date, optionally notifying the assignee. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
- `assigned_to` (`integer`, optional): Stormboard user ID of the assignee, from stormboard_storm_participants_list. Example: 556677.
- `date_completed` (`string`, optional): Completion date (YYYY-MM-DD). Example: 2026-02-12.
- `date_due` (`string`, optional): Due date (YYYY-MM-DD). Example: 2026-02-15.
- `notify` (`integer`, optional): 1 to send the assignee an email or push notification (default), 0 to skip. Example: 1. One of: `0`, `1`.

Example input: `{"idea_id":1000000}`

### `stormboard_idea_update`

Update Idea · Write

Change an idea's content, type, color, shape, position or lock. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data` (`string`, required): New content: text, a video URL, or base64 image, whiteboard or document data. Example: Automate the weekly report (owner: Ana)
- `idea_id` (`integer`, required): Idea ID, from stormboard_storm_ideas_list. Example: 1000000.
- `color` (`string`, optional): New color. Example: green. One of: `yellow`, `light-orange`, `orange`, `red`, `light-green`, `green`, `teal`, `turquoise`, `light-blue`, `blue`, `light-purple`, `purple`, `brown`, `light-pink`, `pink`, `grey`.
- `lock` (`integer`, optional): 1 to lock, 0 to unlock. Example: 1. One of: `0`, `1`.
- `shape` (`string`, optional): New shape. Example: hexagon. One of: `standard`, `gem`, `hexagon`, `octagon`, `square`, `title`, `triangle`.
- `type` (`string`, optional): Idea type. Defaults to text. Example: text. One of: `text`, `title`, `image`, `video`, `document`, `whiteboard`.
- `x` (`integer`, optional): New X position. Example: 420.
- `y` (`integer`, optional): New Y position. Example: 260.

Example input: `{"data":"<data>","idea_id":1000000}`

### `stormboard_idea_vote_add`

Vote for Idea · Write

Cast one of your votes on an idea. Returns the result. Each participant has a limited number of votes per Storm.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"idea_id":1000000}`

### `stormboard_idea_vote_remove`

Remove Idea Vote · Write

Take back your vote from an idea. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"idea_id":1000000}`

### `stormboard_storm_chat_mark_read`

Mark Storm Chat as Read · Write

Mark every chat message in a Storm as read for you. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_chat_message_send`

Send Storm Chat Message · Write

Post a chat message to a Storm's chat for all participants. Returns the new message.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `message` (`string`, required): Text of the chat message. Example: Let's vote on the top three ideas by Friday.
- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"message":"<message>","storm_id":49999}`

### `stormboard_storm_create`

Create Storm · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `plan` (`string`, required): Plan to create the Storm under; team needs team_id. Example: personal. One of: `personal`, `student`, `educator`, `team`.
- `title` (`string`, required): Title of the Storm, up to 100 characters. Example: Q1 Product Retrospective.
- `avatars` (`integer`, optional): 1 to show participants' avatars where they are on the board, 0 to hide. Example: 1. One of: `0`, `1`.
- `description` (`string`, optional): Description or goals of the Storm. Example: What went well, what didn't, and what we'll change.
- `ideacreator` (`integer`, optional): 1 to show the creator's avatar on each idea, 0 to hide. Example: 1. One of: `0`, `1`.
- `team_id` (`integer`, optional): Team ID; required when plan is team. Example: 1234.
- `template` (`integer`, optional): Template ID, from stormboard_templates_list. Example: 12.
- `votesperuser` (`integer`, optional): Votes each participant gets, 0 to 100. Defaults to 10. Example: 5.

Example input: `{"plan":"personal","title":"<title>"}`

### `stormboard_storm_duplicate`

Duplicate Storm · Write

Copy a Storm with its ideas into a new Storm. Returns the new Storm.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
- `stormname` (`string`, optional): Name of the copy; defaults to the original name plus - Duplicate. Example: Q2 Retrospective.

Example input: `{"storm_id":49999}`

### `stormboard_storm_favorite_add`

Star Storm · Write

Star a Storm as a favorite on your dashboard. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_favorite_remove`

Unstar Storm · Write

Remove the favorite star from a Storm. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_invite`

Invite to Storm · Write

Invite people by email to a Storm as contributors or viewers, with an optional message. Stormboard emails them. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `participants` (`array`, required): Email addresses to invite. Example: ["ana@example.com", "lee@example.com"]
- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
- `message` (`string`, optional): Message included in the invitation. Example: Join our retro board before Friday.
- `type` (`string`, optional): Permission of the invitees. Defaults to contributor. Example: contributor. One of: `contributor`, `viewer`.

Example input: `{"participants":["ana@example.com","lee@example.com"],"storm_id":49999}`

### `stormboard_storm_invite_accept`

Accept Storm Invite · Write

Accept an invitation to a Storm so it appears on your dashboard. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_join`

Join Storm · Write

Join a Storm with its ID and private Storm key from the share dialog. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `stormid` (`integer`, required): Storm ID from the share dialog. Example: 49999.
- `stormkey` (`string`, required): Private Storm key from the share dialog. Example: piece335.

Example input: `{"stormid":49999,"stormkey":"<stormkey>"}`

### `stormboard_storm_legend_update`

Update Storm Legend · Write

Set the labels of the Storm's color legend, for example yellow = Ideas, pink = Risks. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `color` (`object`, required): 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_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"color":{"yellow":"Ideas","pink":"Risks"},"storm_id":49999}`

### `stormboard_storm_reopen`

Reopen Storm · Write

Reopen a closed Storm. Returns the result. You must be a Storm administrator or the team owner.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_section_update`

Update Storm Section · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `section_index` (`integer`, required): Index of the section, from stormboard_storm_template_get. Example: 2.
- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
- `character` (`string`, optional): New section marker, up to 2 characters. Example: 1.
- `description` (`string`, optional): New section description. Example: Wins from this quarter.
- `name` (`string`, optional): New section title. Example: What went well.

Example input: `{"section_index":2,"storm_id":49999}`

### `stormboard_storm_tag_create`

Create Storm Tag · Write

Create a tag (a custom field) in a Storm, without values on any idea. Returns the result. Set values with stormboard_idea_tags_set.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Tag name, 1 to 40 characters, not starting with a number or underscore. Example: Owner.
- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"name":"<name>","storm_id":49999}`

### `stormboard_storm_update`

Update Storm · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
- `avatars` (`integer`, optional): 1 to show participants' avatars, 0 to hide. Example: 1. One of: `0`, `1`.
- `description` (`string`, optional): New description or goals. Example: Agree on three actions.
- `ideacreator` (`integer`, optional): 1 to show the creator's avatar on each idea, 0 to hide. Example: 0. One of: `0`, `1`.
- `template` (`integer`, optional): Template ID, from stormboard_templates_list. Example: 12.
- `title` (`string`, optional): New title, up to 100 characters. Example: Q1 Retrospective (final)
- `votesperuser` (`integer`, optional): Votes each participant gets, 0 to 100. Example: 3.

Example input: `{"storm_id":49999}`

### `stormboard_user_notifications_update`

Update My Notifications · Write

Turn your daily activity email, the monthly newsletter and new-participant notifications on or off. Returns the result.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dailyemail` (`integer`, optional): 1 to receive the daily activity email, 0 to stop it. Example: 1. One of: `0`, `1`.
- `newsletter` (`integer`, optional): 1 to receive the monthly newsletter, 0 to stop it. Example: 0. One of: `0`, `1`.
- `newstormuser` (`integer`, optional): 1 to be told when someone joins one of your Storms, 0 to stop it. Example: 1. One of: `0`, `1`.

Example input: `{}`

### `stormboard_connector_delete`

Delete Connector · Destructive

Delete a line connector by ID. Returns the result.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `connector_id` (`integer`, required): Connector ID, from stormboard_storm_connectors_list. Example: 88001.

Example input: `{"connector_id":88001}`

### `stormboard_idea_comment_delete`

Delete Idea Comment · Destructive

Delete one of your comments on an idea. Returns the result.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `comment_id` (`integer`, required): Comment ID, from stormboard_idea_comments_list. Example: 77001.
- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"comment_id":77001,"idea_id":1000000}`

### `stormboard_idea_delete`

Delete Idea · Destructive

Delete an idea from its Storm. Returns the result.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `idea_id` (`integer`, required): Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.

Example input: `{"idea_id":1000000}`

### `stormboard_storm_close`

Close Storm · Destructive

Close an open Storm so participants can no longer change it. Returns the result. Reopen it with stormboard_storm_reopen.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_invite_decline`

Decline Storm Invite · Destructive

Decline an invitation to a Storm and remove it from your list. Returns the result.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

### `stormboard_storm_leave`

Leave Storm · Destructive

Leave a Storm so it is removed from your dashboard. Returns the result.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `storm_id` (`integer`, required): Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.

Example input: `{"storm_id":49999}`

## Related

Other Collaboration connectors ([all 61](/agentkit/connectors/?category=collaboration)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
