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

# GPTBots integration for LuumenAI

Read GPTBots agents, conversations, and credit use, then open a new conversation

## What LuumenAI can do with GPTBots

LuumenAI connects to GPTBots with an API token and exposes 12 tools (10 read-only · 1 write · 1 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: 12 tools (10 read-only · 1 write · 1 destructive)
- Plan: available on all plans
- Category: AI & automation

## About GPTBots with LuumenAI

Connect the GPTBots agent behind your Singapore Agent API Key and Luumen can answer questions about it directly: which knowledge bases and documents are attached, what conversations ran in the last week, what credits each one consumed, and which attributes are set on a given user. When you need a live conversation opened or a message sent to the agent, Luumen previews the call and waits for your approval.

## Example tools

Read-only (10 in total):

- `GPTBOTS_GET_AGENT_INFORMATION` — Return the GPTBots Agent bound to the connected Agent API Key, including its ID and runtime configuration.
- `GPTBOTS_GET_TOTAL_CREDIT_CONSUMPTION` — Return aggregate Agent credit consumption by category for a reporting range of up to 365 days.
- `GPTBOTS_LIST_CONVERSATION_CREDITS` — Return one page of per-conversation Agent credit consumption for a time range of up to 30 days, optionally filtered by conversation ID.
- `GPTBOTS_LIST_CONVERSATION_MESSAGES` — Return one page of current v2 message details for a GPTBots conversation.
- `GPTBOTS_LIST_CONVERSATIONS` — Return one page of Agent conversations filtered by source, recent-chat time range, and optional user.
- `GPTBOTS_LIST_DATABASE_TABLES` — Return database tables configured for the Agent ID supplied by the caller.
- `GPTBOTS_LIST_KNOWLEDGE_BASES` — Return all knowledge bases attached to the GPTBots Agent connected by this API key.
- `GPTBOTS_LIST_KNOWLEDGE_DOCUMENTS` — Return one page of documents in a GPTBots knowledge base.

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

- `GPTBOTS_CREATE_CONVERSATION` — Create a GPTBots conversation for a developer-defined user on the Agent connected by this API key.
- `GPTBOTS_SEND_MESSAGE` — Send the latest user text to a GPTBots conversation and wait for the Agent's complete blocking response.

## Frequently asked questions

### How does LuumenAI connect to GPTBots?

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 GPTBots on its own?

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

### Is there an audit trail?

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

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