# Carbone AI integration on Definable

> Carbone is a fast and simple report generator that converts JSON data into various document formats such as PDF, DOCX, XLSX, ODT, and more, using templates.

## What this connects

Carbone is a fast and simple report generator that converts JSON data into various document formats such as PDF, DOCX, XLSX, ODT, and more, using templates.

Vendor: https://account.carbone.io/

## Tools available

**11** tools available. First 11:

- `CARBONE_DELETE_TEMPLATE` — Delete Carbone Template — Permanently delete a template from the Carbone server by its 64-character hexadecimal template ID. This action is irreversible. Ensure you have the correct template ID before deleting.
- `CARBONE_DOWNLOAD_TEMPLATE` — Download Template — Tool to download a template from Carbone by template ID. Use when you need to retrieve the original template file.
- `CARBONE_GENERATE_REPORT` — Generate Carbone Report — Tool to generate a Carbone report from a template and JSON data. Use when you need to render documents in various formats.
- `CARBONE_GET_STATUS` — Get Carbone Server Status — Tool to retrieve the current status and health of the Carbone server. Use before generating reports to ensure the service is operational.
- `CARBONE_LIST_TEMPLATE_CATEGORIES` — List Template Categories — Tool to retrieve a list of all categories used in templates. Categories function like folders for organizing templates. Use when you need to see available template groupings.
- `CARBONE_LIST_TEMPLATES` — List Templates — Tool to retrieve a list of templates from Carbone storage with filtering, search, and cursor-based pagination. Use when you need to find templates, search by name or ID, or iterate through all deployed templates.
- `CARBONE_LIST_TEMPLATE_TAGS` — List Template Tags — Tool to list all tags currently used in templates. Use when you need to discover available tags for categorizing or filtering templates by document type or version.
- `CARBONE_RENDER_TEMPLATE_DIRECT` — Render Template Direct — Tool to generate a document by uploading a base64-encoded template and data in a single API call. Use when you need to render documents without uploading templates separately.
- `CARBONE_SET_API_VERSION` — Set Carbone API Version — Tool to set the Carbone API version to be used for subsequent requests. Use before rendering or managing templates to ensure correct version is applied.
- `CARBONE_UPDATE_TEMPLATE` — Update Template Metadata — Tool to update metadata and attributes of an existing Carbone template. Use when you need to modify template name, comment, tags, category, or control version deployment and lifecycle.
- `CARBONE_UPLOAD_TEMPLATE` — Upload a template — Upload a template file to the Carbone server to obtain a template ID for document generation. Supported template formats: DOCX, XLSX, PPTX, ODT, ODS, ODP, ODG, XHTML, IDML, HTML, or XML. Templates can contain placeholders like {d.fieldname} that will be replaced with data during report generation.

## Auth

Auth schemes: `API_KEY`.

## How agents use Carbone

Inside a Definable workflow, Carbone is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Carbone** — the Researcher (GPT-5.5) pulls context from Carbone (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Carbone** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Carbone (create record, post message, draft email).
- **Designer / Engineer → Distributor → Carbone** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Carbone (attach file, open PR comment, post status).

The Verifier checks every Carbone call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- documents — https://definable.ai/apps/category/documents/

## Related

- HTML page: https://definable.ai/apps/carbone/
- Same category (documents): https://definable.ai/apps/category/documents/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt