Templates
A template defines the visual layout and size used when generating a carousel. Use this endpoint to discover the templates available in your workspace, then reference a template id when generating designs.
Requires the embed-api-key header — see
Authentication.
List templates
GET /templateReturns templates in your workspace, most recently updated first.
Query parameters
| Parameter | Default | Description |
|---|---|---|
page | 1 | Page number (positive integer). |
limit | 10 | Items per page (1–100). |
Response 200
{
"success": true,
"data": {
"templates": [
{
"id": "template_123",
"name": "Bold Headlines",
"size": "1080x1350"
}
]
}
}| Field | Description |
|---|---|
id | Template id — pass this when generating a carousel. |
name | Human-readable template name. |
size | The template’s canvas size. |
Errors
| Status | Body | When |
|---|---|---|
404 | { "success": false, "message": "No templates found" } | The workspace has no templates. |
422 | { "status": false, "message": "Page must be a positive integer" } | Invalid page. |
422 | { "status": false, "message": "Limit must be between 1 and 100" } | Invalid limit. |
500 | { "success": false, "message": "Error fetching Templates", ... } | Unexpected server error. |
See Authentication for 401 / 402 responses.
Last updated on