> **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 BotStar

The BotStar connector lets your AI agent act in each user's BotStar account. Each user connects their own BotStar access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** Bearer Token
**Categories:** Communication, Customer Support
**Tools:** 25: 8 read, 13 write, 4 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BOTSTAR)

## 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 BotStar connection

   In **AgentKit > Connections**, create a BotStar 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 = 'botstar'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize BotStar:', 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: 'botstar_bots_list',
     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 = "botstar"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize BotStar:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="botstar_bots_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their BotStar 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: 'botstar_bot_attributes_list',
  toolInput: {
    bot_id: '<bot_id>',
  },
  connector: 'botstar',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="botstar_bot_attributes_list",
    tool_input={
        "bot_id": "<bot_id>",
    },
    connection_name="botstar",
    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.

### `botstar_bot_attributes_list`

List Bot Attributes · Read-only

List a bot's attributes (bot-wide variables such as business hours or a phone number).
Returns each attribute's ID, name, data type, value and per-language values.
Use botstar_bot_attributes_list to read bot variables.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `env` (`string`, optional): Which version to read: draft or live. One of: draft, live. Example: live. One of: `draft`, `live`.

Example input: `{"bot_id":"<bot_id>"}`

### `botstar_bot_get`

Get Bot · Read-only

Get one bot by ID.
Returns the bot's name, languages, channels and settings.
Use botstar_bot_get to check a bot's configuration.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d

Example input: `{"bot_id":"<bot_id>"}`

### `botstar_bots_list`

List Bots · Read-only

List the bots in your BotStar account.
Returns each bot's ID, name and settings.
Use botstar_bots_list to find a bot_id for the other tools.

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

Inputs: none.

Example input: `{}`

### `botstar_cms_entities_list`

List CMS Entities · Read-only

List a bot's CMS entities (content tables such as products or FAQs).
Returns each entity's ID, name and fields.
Use botstar_cms_entities_list to find an entity_id. Use botstar_cms_items_list for its rows.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `env` (`string`, optional): Which version to read: draft or live. One of: draft, live. Example: live. One of: `draft`, `live`.

Example input: `{"bot_id":"<bot_id>"}`

### `botstar_cms_entity_get`

Get CMS Entity · Read-only

Get one CMS entity with its fields.
Returns the entity's name and field definitions.
Use botstar_cms_entity_get to see which fields an item can have.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `env` (`string`, optional): Which version to read: draft or live. One of: draft, live. Example: live. One of: `draft`, `live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>"}`

### `botstar_cms_item_get`

Get CMS Item · Read-only

Get one CMS item.
Returns the item's name, status and field values.
Use botstar_cms_item_get when you know the item ID.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `item_id` (`string`, required): CMS entity item ID, from botstar_cms_items_list. Example: i1a2b3c4d5e6f7a8b9c0d1e2f
- `env` (`string`, optional): Which version to read: draft or live. One of: draft, live. Example: live. One of: `draft`, `live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","item_id":"<item_id>"}`

### `botstar_cms_items_list`

List CMS Items · Read-only

List the items (rows) of a CMS entity, optionally by name or status.
Returns a page of items with their field values.
Use botstar_cms_items_list to read content. Use botstar_cms_item_get for one item.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `env` (`string`, optional): Which version to read: draft or live. One of: draft, live. Example: live. One of: `draft`, `live`.
- `limit` (`integer`, optional): Items per page (default 100). Example: 50
- `name` (`string`, optional): Only items with this name. Example: Blue T-shirt
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `status` (`string`, optional): enabled or disabled. One of: enabled, disabled. Example: enabled. One of: `enabled`, `disabled`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>"}`

### `botstar_user_get`

Get User · Read-only

Get a chat user of a bot with their attributes.
Returns the user's profile and user attributes (standard and custom).
Use botstar_user_get to read what the bot knows about a user.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `user_id` (`string`, required): Chat user ID (shown under Report & Insight > Audience in BotStar). Example: 2849192718472910

Example input: `{"bot_id":"<bot_id>","user_id":"<user_id>"}`

### `botstar_bot_attribute_create`

Create Bot Attribute · Write

Create a bot attribute, optionally with a value per language for multilingual bots.
Returns the created attribute.
Use botstar_bot_attribute_create for a new bot-wide variable. Use botstar_bot_attribute_update to change its value.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `data_type` (`string`, required): string, number or date. One of: string, number, date. Example: string. One of: `string`, `number`, `date`.
- `name` (`string`, required): Attribute name, at most 250 characters. Example: support_phone
- `desc` (`string`, optional): Description. Example: Support phone shown in the menu
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.
- `language_values` (`object`, optional): Values for other bot languages, keyed value_<language code>. Example: {"value_es": "+34 555 0100"}
- `value` (`string`, optional): Value (YYYY-MM-DD for date attributes). Example: +1 555 0100

Example input: `{"bot_id":"<bot_id>","data_type":"string","name":"<name>"}`

### `botstar_bot_attribute_update`

Update Bot Attribute · Write

Update a bot attribute's description or values.
Returns the updated attribute.
Use botstar_bot_attribute_update to change a bot-wide variable; use env draft,live to change the live bot too.

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

Inputs:

- `attribute_id` (`string`, required): Bot attribute ID, from botstar_bot_attributes_list. Example: a1b2c3d4e5
- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `desc` (`string`, optional): Description. Example: Support phone shown in the menu
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.
- `language_values` (`object`, optional): Values for other bot languages, keyed value_<language code>. Example: {"value_es": "+34 555 0199"}
- `value` (`string`, optional): New value. Example: +1 555 0199

Example input: `{"attribute_id":"<attribute_id>","bot_id":"<bot_id>"}`

### `botstar_bot_create`

Create Bot · Write

Create a new, empty bot.
Returns the created bot with its ID.
Use botstar_bot_create to start a bot, then build its flows in the BotStar app.

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

Inputs:

- `name` (`string`, required): Bot name. Example: Support Bot

Example input: `{"name":"<name>"}`

### `botstar_bot_publish`

Publish Bot · Write

Publish a bot's draft changes to live.
Returns the publish result.
Use botstar_bot_publish after editing attributes or CMS data in draft so users see the changes.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d

Example input: `{"bot_id":"<bot_id>"}`

### `botstar_cms_entity_create`

Create CMS Entity · Write

Create a CMS entity with optional fields.
Returns the created entity with its ID.
Use botstar_cms_entity_create to add a content table. Use botstar_cms_entity_fields_create to add fields later.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `name` (`string`, required): Entity name. Example: Products
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.
- `fields` (`array`, optional): Fields, each with unique_name, name and data_type (for example text, multiple_values, single_option, multiple_options, number, image, date). Option fields add options.predefined_data, a list of value and label pairs. Example: [{"unique_name": "price", "name": "Price", "data_type": "text"}]

Example input: `{"bot_id":"<bot_id>","name":"<name>"}`

### `botstar_cms_entity_fields_create`

Create CMS Entity Fields · Write

Add one or more fields to a CMS entity.
Returns the entity's fields.
Use botstar_cms_entity_fields_create to extend a content table.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `fields` (`array`, required): Fields, each with unique_name, name and data_type (for example text, multiple_values, single_option, multiple_options, number, image, date). Option fields add options.predefined_data, a list of value and label pairs. Example: [{"unique_name": "color", "name": "Color", "data_type": "single_option", "options": {"predefined_data": [{"value": "red", "label": "Red"}]}}]
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","fields":[{"unique_name":"price","name":"Price","data_type":"text"}]}`

### `botstar_cms_entity_fields_update`

Update CMS Entity Fields · Write

Rename fields or change their options; fields are matched by unique_name.
Returns the entity's fields.
Use botstar_cms_entity_fields_update to edit existing fields. Send a JSON array even for one field.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `fields` (`array`, required): Fields to update, each with its unique_name and the new name and/or options.predefined_data. Example: [{"unique_name": "color", "name": "Product colors", "options": {"predefined_data": [{"value": "red", "label": "Red"}, {"value": "black", "label": "Black"}]}}]
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","fields":[{"unique_name":"price","name":"Price","data_type":"text"}]}`

### `botstar_cms_entity_update`

Rename CMS Entity · Write

Rename a CMS entity.
Returns the updated entity.
Use botstar_cms_entity_update to rename. Use botstar_cms_entity_fields_update to change fields.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `name` (`string`, required): New entity name. Example: Product catalog
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","name":"<name>"}`

### `botstar_cms_item_create`

Create CMS Item · Write

Create an item (row) in a CMS entity.
Returns the created item with its ID.
Use botstar_cms_item_create to add content. Field values go in field_values keyed by each field's unique_name.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `name` (`string`, required): Item name. Example: Blue T-shirt
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.
- `field_values` (`object`, optional): Field values keyed by field unique_name; multi-value fields take arrays. Example: {"price": "19.99", "color": ["blue"]}
- `status` (`string`, optional): enabled or disabled. One of: enabled, disabled. Example: enabled. One of: `enabled`, `disabled`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","name":"<name>"}`

### `botstar_cms_item_update`

Update CMS Item · Write

Update a CMS item's name, status or field values.
Returns the updated item.
Use botstar_cms_item_update to change content; use env draft,live to update the live bot too.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `item_id` (`string`, required): CMS entity item ID, from botstar_cms_items_list. Example: i1a2b3c4d5e6f7a8b9c0d1e2f
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.
- `field_values` (`object`, optional): Field values keyed by field unique_name. Example: {"price": "17.99"}
- `name` (`string`, optional): Item name. Example: Blue T-shirt (2026)
- `status` (`string`, optional): enabled or disabled. One of: enabled, disabled. Example: disabled. One of: `enabled`, `disabled`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","item_id":"<item_id>"}`

### `botstar_message_send`

Send Facebook Message · Write

Send a message to a Facebook Messenger user of a bot, outside the 24-hour window only with an allowed message tag.
Returns the send result.
Use botstar_message_send for order or account updates to Messenger users. The message follows BotStar's JSON message format.

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

Inputs:

- `message` (`object`, required): Message in BotStar JSON format, for example {"text": "Hello"}, or a template with buttons or cards. Example: {"text": "Your order has shipped."}
- `recipient_id` (`string`, required): The Messenger user ID to send to. Example: 2849192718472910
- `message_tag` (`string`, optional): Messenger tag needed outside the 24-hour window. One of: CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE. Example: POST_PURCHASE_UPDATE. One of: `CONFIRMED_EVENT_UPDATE`, `POST_PURCHASE_UPDATE`, `ACCOUNT_UPDATE`.

Example input: `{"message":{"text":"Your order has shipped."},"recipient_id":"<recipient_id>"}`

### `botstar_user_attribute_create`

Create Custom User Attribute · Write

Create a custom user attribute (a per-user variable) for a bot.
Returns the created attribute.
Use botstar_user_attribute_create before setting the attribute with botstar_user_attributes_update.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `field_name` (`string`, required): Attribute name. Example: plan
- `field_type` (`string`, required): Data type. One of: string, number, date, boolean. Example: string. One of: `string`, `number`, `date`, `boolean`.

Example input: `{"bot_id":"<bot_id>","field_name":"<field_name>","field_type":"string"}`

### `botstar_user_attributes_update`

Update User Attributes · Write

Update a chat user's standard and custom attributes.
Returns the updated user.
Use botstar_user_attributes_update to sync CRM data into the bot. Create custom attributes first with botstar_user_attribute_create.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `user_id` (`string`, required): Chat user ID (shown under Report & Insight > Audience in BotStar). Example: 2849192718472910
- `birthday` (`string`, optional): Birthday, YYYY-MM-DD. Example: 1990-04-12
- `custom_attributes` (`object`, optional): Custom user attribute values keyed by attribute name. Example: {"plan": "pro", "order_count": 3}
- `email` (`string`, optional): Email. Example: jane@example.com
- `first_name` (`string`, optional): First name. Example: Jane
- `gender` (`string`, optional): Gender. Example: female
- `last_name` (`string`, optional): Last name. Example: Doe

Example input: `{"bot_id":"<bot_id>","user_id":"<user_id>"}`

### `botstar_bot_attribute_delete`

Delete Bot Attribute · Destructive

Delete a bot attribute.
Returns a confirmation.
Use botstar_bot_attribute_delete to remove a variable no flow uses.

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

Inputs:

- `attribute_id` (`string`, required): Bot attribute ID, from botstar_bot_attributes_list. Example: a1b2c3d4e5
- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"attribute_id":"<attribute_id>","bot_id":"<bot_id>"}`

### `botstar_cms_entity_delete`

Delete CMS Entity · Destructive

Delete a CMS entity and its items.
Returns a confirmation.
Use botstar_cms_entity_delete to remove a content table permanently.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>"}`

### `botstar_cms_entity_fields_delete`

Delete CMS Entity Fields · Destructive

Delete fields from a CMS entity by unique name.
Returns a confirmation.
Use botstar_cms_entity_fields_delete to remove fields and their data from every item.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `unique_names` (`string`, required): Comma-separated unique_names of the fields to delete. Example: color,size
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","unique_names":"<unique_names>"}`

### `botstar_cms_item_delete`

Delete CMS Item · Destructive

Delete a CMS item.
Returns a confirmation.
Use botstar_cms_item_delete to remove content. Use botstar_cms_item_update with status disabled to hide it instead.

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

Inputs:

- `bot_id` (`string`, required): Bot ID, from botstar_bots_list or the Bot Builder URL. Example: s5d8f1c2a-3b4e-4f6a-9c1d-2e7f8a9b0c1d
- `entity_id` (`string`, required): CMS entity ID, from botstar_cms_entities_list. Example: e8a1b2c3d4e5f6a7b8c9d0e1f
- `item_id` (`string`, required): CMS entity item ID, from botstar_cms_items_list. Example: i1a2b3c4d5e6f7a8b9c0d1e2f
- `env` (`string`, optional): Which version to change: draft, or draft,live to change both at once. One of: draft, draft,live. Example: draft,live. One of: `draft`, `draft,live`.

Example input: `{"bot_id":"<bot_id>","entity_id":"<entity_id>","item_id":"<item_id>"}`

## Related

Other Communication connectors ([all 132](/agentkit/connectors/?category=communication)):

- [Gmail](/agentkit/connectors/gmail/): Scalekit connector, OAuth, 48 tools
- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 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 |
