---
title: "Carbone integration for LuumenAI"
url: "https://www.luumen.ai/integrations/carbone/"
entity: SoftwareIntegration
category: "Knowledge & documentation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Carbone integration for LuumenAI

Turn JSON from your systems into PDFs, spreadsheets, and documents from templates

## What LuumenAI can do with Carbone

LuumenAI connects to Carbone with an API token and exposes 11 tools (7 read-only · 3 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: 11 tools (7 read-only · 3 write · 1 destructive)
- Plan: available on all plans
- Category: Knowledge & documentation

## About Carbone with LuumenAI

Carbone renders JSON data into PDF, DOCX, XLSX, ODT, and other formats using templates you already maintain. Connect it and Luumen can list what templates exist, check their tags and categories, confirm the server is healthy, and generate a document when you ask. Authentication is by API key.

## Example tools

Read-only (7 in total):

- `CARBONE_DOWNLOAD_TEMPLATE` — Download a template from Carbone by template ID.
- `CARBONE_GET_STATUS` — Retrieve the current status and health of the Carbone server.
- `CARBONE_LIST_TEMPLATE_CATEGORIES` — Retrieve a list of all categories used in templates.
- `CARBONE_LIST_TEMPLATES` — Retrieve a list of templates from Carbone storage with filtering, search, and cursor-based pagination.
- `CARBONE_LIST_TEMPLATE_TAGS` — List all tags currently used in templates.
- `CARBONE_RENDER_TEMPLATE_DIRECT` — Generate a document by uploading a base64-encoded template and data in a single API call.
- `CARBONE_SET_API_VERSION` — Set the Carbone API version to be used for subsequent requests.

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

- `CARBONE_DELETE_TEMPLATE` — Permanently delete a template from the Carbone server by its 64-character hexadecimal template ID.
- `CARBONE_GENERATE_REPORT` — Generate a Carbone report from a template and JSON data.
- `CARBONE_UPDATE_TEMPLATE` — Update metadata and attributes of an existing Carbone template.
- `CARBONE_UPLOAD_TEMPLATE` — Upload a template file to the Carbone server to obtain a template ID for document generation.

## Frequently asked questions

### How does LuumenAI connect to Carbone?

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

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