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

# Botpress integration for LuumenAI

Read Botpress workspaces, bots, and usage, then make changes as approved steps

## What LuumenAI can do with Botpress

LuumenAI connects to Botpress with an API token and exposes 53 tools (36 read-only · 13 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: 53 tools (36 read-only · 13 write · 4 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Botpress with LuumenAI

Connect Botpress and your agent can answer questions about workspaces, bots, and the integrations and plugins they depend on. It reads account details, quota completion, and per-bot usage on request. Changes — creating a bot, adding an integration, sending a message into a conversation — are previewed and held for approval by default. Authentication is by API key.

## Example tools

Read-only (36 in total):

- `BOTPRESS_BREAK_DOWN_WORKSPACE_USAGE_BY_BOT` — Break down workspace usage by bot.
- `BOTPRESS_CHECK_HANDLE_AVAILABILITY` — Check if a workspace handle is available in Botpress.
- `BOTPRESS_GET_ACCOUNT` — Get details of the authenticated account.
- `BOTPRESS_GET_ACCOUNT_PREFERENCE` — Get a preference of the account.
- `BOTPRESS_GET_ALL_WORKSPACE_QUOTA_COMPLETION` — Get a map of workspace IDs to their highest quota completion rate.
- `BOTPRESS_GET_DEREFERENCED_PUBLIC_PLUGIN_BY_ID` — Get a public plugin by ID with all interface entity references resolved to the corresponding entities as extended by the backing integrations.
- `BOTPRESS_GET_INTEGRATION` — Get a specific Botpress integration by name and version.
- `BOTPRESS_GET_PUBLIC_INTEGRATION` — Retrieve a public integration by name and version from the Botpress hub.

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

- `BOTPRESS_CHARGE_WORKSPACE_UNPAID_INVOICES` — Charge unpaid invoices for a specific Botpress workspace.
- `BOTPRESS_CREATE_ADMIN_INTEGRATION` — Create a new integration in a Botpress workspace via the Admin API.
- `BOTPRESS_CREATE_ADMIN_WORKSPACE` — Create a new workspace in Botpress via the Admin API.
- `BOTPRESS_CREATE_BOT` — Create a new bot in a Botpress workspace via the Admin API.
- `BOTPRESS_CREATE_CONVERSATION` — Create a new conversation in Botpress via the Runtime API.
- `BOTPRESS_DELETE_ADMIN_WORKSPACE` — Permanently delete a workspace from Botpress admin.
- `BOTPRESS_DELETE_FILE` — Permanently deletes a file from a Botpress bot's storage by its file ID.
- `BOTPRESS_DELETE_INTEGRATION_SHAREABLE_ID` — Delete a shareable ID for an integration installed in a Botpress bot.

## Frequently asked questions

### How does LuumenAI connect to Botpress?

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 Botpress 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 Botpress — read or write, approved or declined — is recorded with the actor, the input, and the result.

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