# 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
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `CARBONE`
- **Version:** 20260312_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.

### 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.