Carbone

11 tools available

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.

Connect Carbone to Definable to auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas call Carbone's 11 tools directly from chat or scheduled flows. Connect this integration to a knowledge persona — the agent will ground answers in your documents with citations.

Common workflows with Carbone

01

Auto-index new files

  1. Watch for new uploads
  2. Chunk, embed, and index
  3. Make queryable via your knowledge persona
02

Q&A against a folder

  1. Pin a folder as a brain
  2. Ask the persona questions
  3. Returns answers with citations
03

Document-trigger flows

  1. New contract uploaded
  2. Persona extracts key terms
  3. Routes to the right approver

Carbone actions 11

Every Carbone action below is a callable tool any Definable persona can invoke.

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.

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

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

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

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

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

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

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

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

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

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.

Frequently asked questions

What can I automate with Carbone on Definable?

Anything Carbone exposes through its API. Common documents workflows on Definable include auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas can call any of the 11 Carbone tools directly, then chain the result into another integration without you writing code.

How does Carbone authentication work?

Carbone uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Carbone integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 11 Carbone tools. You only need a separate Carbone subscription if Carbone itself charges per seat or per API call.

Is using Carbone through Definable secure?

Every call from a persona to Carbone is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Carbone on Definable?

Sign up for Definable, open the integrations page, find Carbone, and connect via OAuth or API key. You can immediately attach Carbone to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Carbone actions does Definable expose?

Definable exposes all 11 Carbone actions as callable tools — including `Delete Carbone Template`, `Download Template`, `Generate Carbone Report`, plus 8 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Carbone?

Wire it up in minutes. No coding required.

← All integrations