Everything about Template Storage

To generate documents, two elements are required: a template (created from your text editor) and a JSON data-set (the data injected to generate the report).
When you subscribe to a plan, it is possible to store templates through two services: Carbone Render API or Carbone Studio. A plan will give you storage space for many templates. If additional templates are uploaded, they are charged at the billing period's end.

How to store templates

Carbone Studio

Uploaded templates through Carbone Studio are persistent, and you will be able to
Preview and Design report.
Manage templates with versioning and labeling.
Use template IDs to generate reports through the Carbone Render API.
Access templates in Carbone Account (listing and download only).

Carbone Render API

When you request the API with the:
Production Token: Templates are persistent by default. It is possible to upload a non-persistent template by adding the header carbone-template-delete-after with days in seconds (86400s = 1 day, max 30 days).
Test Token: Templates are non-persistent only and will be deleted within 30 days. The duration can be reduced by passing the header carbone-template-delete-after with days in seconds (86400s = 1 day, max 30 days). Non-persistent are counted on the total number of stored templates given by your subscription. Once a template is automatically deleted, a template storage slot becomes free. It is impossible to make a template persistent with the test API token.

Note: uploaded templates through the API are:
accessible in Carbone Account (listing and download only).
not accessible in Carbone Studio.

How to delete templates

It is possible to delete templates through Carbone Render API and Carbone Studio.
All of your templates will be deleted within 30 days if you cancel your subscription.
All of your templates are deleted instantaneously, if you delete your account,

Supported template types

Carbone accepts only XML-based templates:

Note: Carbone can generate many reports formats, learn about the supported files and features list.

If you need to store templates and render reports on your own infrastructure, reach us on the chat to access Carbone On-premise 🚀
Was this article helpful?
Thank you!