POST
/
v1
/
templates
Upload a Template
curl --request POST \
  --url https://smart-templates.sandbox.midaz.io/v1/templates \
  --header 'Content-Type: multipart/form-data' \
  --form outputFormat=csv \
  --form 'description=OPEINTRA Template' \
  --form template=@example-file
{
  "id": "0196b270-a315-7137-9408-3f16af2685e1",
  "outputFormat": "csv",
  "description": "OPEINTRA Template",
  "filename": "0196b270-a315-7137-9408-3f16af2685e1.tpl",
  "createdAt": "2025-05-09T00:27:28.405080783Z"
}

Headers

​
Authorization
string

The authorization token. Important: This header is required if your environment has the Acces Manager plugin enabled.

​
Content-Type
string

The request content type. Important: For this endpoint, it must be multipart/form-data.

​
X-Organization-id
string

The unique identifier of the Organization associated with the request.

Body

multipart/form-data
​
template
file
required

The .tpl file you've created to serve as the template definition.

​
outputFormat
enum<string>
required

The format of the report that the template will generate.

Available options:
HTML,
CSV,
XML,
PDF,
TXT
Example:

"csv"

​
description
string

A brief description about the template.

Example:

"OPEINTRA Template"

Response

Indicates that the resource was successfully created and the operation was completed as expected.

Details about the template that was created.

​
id
string

Unique ID that identifies the template (UUID format).

​
outputFormat
string

The format of the generated output (e.g., HTML, CSV, PDF, TXT, XML).

​
description
string

Briefly describes what the template is for or what it contains.

​
fileName
string

The name of the template file as stored in the system. Follows the <template_id>.tpl format.

​
createdAt
string

Timestamp indicating when the template was created.