Skip to main content
POST
/
api
/
v1
/
templates
Upload template
curl --request POST \
  --url https://api.example.com/api/v1/templates \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "filename": "<string>",
  "org_name": "<string>",
  "file_size": 123,
  "metadata": {
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "description": "<string>",
    "version": "<string>"
  }
}
'
{
  "template_id": "<string>",
  "upload_url": "<string>",
  "expires_in": 123,
  "status": "pending",
  "upload_method": "signed_url",
  "max_file_size": 10485760,
  "allowed_extensions": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://duomi.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Production API key. Development/test deployments may also allow X-Org-Name.

Body

application/json

Request schema for template upload initiation.

​
filename
string
required

Name of the template file

​
org_name
string | null

Organization name for multi-tenancy. If provided, must match the API key's organization. If omitted, the API key's organization is used.

​
file_size
integer | null

File size in bytes (for pre-validation)

​
metadata
TemplateMetadata · object

Template metadata.

Response

Successful Response

Response schema for template upload initiation.

​
template_id
string
required
​
upload_url
string
required
​
expires_in
integer
required

URL expiration time in seconds

​
status
string
default:pending
​
upload_method
string
default:signed_url
​
max_file_size
integer
default:10485760

Maximum file size in bytes (10MB)

​
allowed_extensions
string[]