---
title: "Botstar integration for LuumenAI"
url: "https://www.luumen.ai/integrations/botstar/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Botstar integration for LuumenAI

Read bots, CMS entities, and attributes in BotStar, then change them with approval

## What LuumenAI can do with Botstar

LuumenAI connects to Botstar with an API token and exposes 31 tools (16 read-only · 11 write · 4 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 31 tools (16 read-only · 11 write · 4 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Botstar with LuumenAI

Connect BotStar and Luumen can read your bots, their CMS entities and items, and every bot attribute without leaving the terminal. When something needs to change — a new entity item, an updated attribute, a publish to live — Luumen shows the exact call first and waits for your approval by default. Authentication is by API key.

## Example tools

Read-only (16 in total):

- `BOTSTAR_GET_BOT` — Get your bot by bot ID.
- `BOTSTAR_GET_BOT_APP_ID` — Retrieve the BotStar application ID (`appId`).
- `BOTSTAR_GET_CMS_ENTITY` — Get a specific CMS entity by ID.
- `BOTSTAR_GET_ENTITY_ITEM` — Retrieve a specific item from a CMS entity with all field values.
- `BOTSTAR_LIST_BOT_ATTRIBUTES` — Get all bot attributes from BotStar.
- `BOTSTAR_LIST_BOTS` — Get your list of bots.
- `BOTSTAR_LIST_CMS_ENTITIES` — Retrieve all CMS entities for a bot.
- `BOTSTAR_LIST_ENTITY_ITEMS` — Retrieve all entity items with pagination support.

Write and destructive (15 in total, approval required by default):

- `BOTSTAR_CREATE_BOT` — Create a new bot in BotStar.
- `BOTSTAR_CREATE_BOT_ATTRIBUTE` — Create a new bot attribute in BotStar.
- `BOTSTAR_CREATE_CMS_ENTITY` — Create a CMS entity in BotStar with a name and optional fields.
- `BOTSTAR_CREATE_ENTITY_FIELDS` — Create entity field(s) in BotStar CMS.
- `BOTSTAR_CREATE_ENTITY_ITEM` — Create a new entity item in BotStar CMS.
- `BOTSTAR_CREATE_USER_ATTRIBUTES` — Create custom user attributes in BotStar.
- `BOTSTAR_DELETE_BOT_ATTRIBUTE` — Delete a bot attribute by ID.
- `BOTSTAR_DELETE_CMS_ENTITY` — Delete a CMS entity by ID.

## Frequently asked questions

### How does LuumenAI connect to Botstar?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Botstar on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 4 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Botstar — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/botstar/