Skip to main content
Templates provide reusable content structures for creatives, emails, and other communications. They support variables for dynamic personalization.

​
GET /api/v1/templates

List templates, optionally filtered by category.

​
Query Parameters

ParameterTypeRequiredDescription
categorystringNoFilter by category (e.g., email, sms, push, banner)

​
Response

[
  {
    "id": "clx...",
    "name": "Welcome Email",
    "description": "New customer welcome email template",
    "category": "email",
    "type": "html",
    "content": { "subject": "Welcome!", "body": "<h1>Hello {{name}}</h1>..." },
    "variables": { "name": "string", "offer_name": "string" },
    "isSystem": false,
    "tenantId": "my-tenant",
    "createdAt": "2026-03-18T12:00:00.000Z"
  }
]

​
POST /api/v1/templates

Create a new template. Editor or Admin.

​
Request Body

FieldTypeRequiredDescription
namestringYesTemplate name (max 255 chars, unique per tenant)
descriptionstringNoTemplate description
categorystringYesTemplate category (e.g., email, sms, push, banner)
typestringYesContent type (e.g., html, text, json)
contentobjectYesTemplate content (structure depends on type)
variablesobjectNoVariable definitions with types
isSystembooleanNoMark as system template (default: false)

​
Example

curl -X POST https://playground.kaireonai.com/api/v1/templates \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "Promotional Banner",
    "category": "banner",
    "type": "json",
    "content": {
      "headline": "{{headline}}",
      "cta": "{{cta_text}}",
      "image_url": "{{image}}"
    },
    "variables": {
      "headline": "string",
      "cta_text": "string",
      "image": "string"
    }
  }'

​
Response (201)

Returns the created template object.

​
GET /api/v1/templates/

Get a single template by ID.

​
PUT /api/v1/templates/

Update a template. Editor or Admin.

​
Request Body

Same fields as POST, all optional.

​
DELETE /api/v1/templates/

Delete a template. System templates cannot be deleted. Admin only.

​
Response

204 No Content on success.

​
Error — System Template

{ "error": "System templates cannot be deleted" }