# Carbone

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.

- **Category:** documents
- **Auth:** API_KEY
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `CARBONE`
- **Version:** 20260217_00

## Tools

### Delete Carbone Template

**Slug:** `CARBONE_DELETE_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.

### Download Template

**Slug:** `CARBONE_DOWNLOAD_TEMPLATE`

Tool to download a template from Carbone by template ID. Use when you need to retrieve the original template file.

### Generate Carbone Report

**Slug:** `CARBONE_GENERATE_REPORT`

Tool to generate a Carbone report from a template and JSON data. Use when you need to render documents in various formats.

### Generate Template ID

**Slug:** `CARBONE_GENERATE_TEMPLATE_ID`

Upload a template to Carbone and get its unique template ID (SHA256 hash). The template ID can then be used with Generate Report to create documents. Same template content always returns the same ID (idempotent).

### Get Carbone Server Status

**Slug:** `CARBONE_GET_STATUS`

Tool to retrieve the current status and health of the Carbone server. Use before generating reports to ensure the service is operational.

### List Template Categories

**Slug:** `CARBONE_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.

### List Templates

**Slug:** `CARBONE_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.

### List Template Tags

**Slug:** `CARBONE_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.

### Render Template Direct

**Slug:** `CARBONE_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.

### Set Carbone API Version

**Slug:** `CARBONE_SET_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.

### Update Template Metadata

**Slug:** `CARBONE_UPDATE_TEMPLATE`

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.

### Upload a template

**Slug:** `CARBONE_UPLOAD_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.
