Mager API

List templates

GET/api/v1/templates

Templates are presets for a model. Pass template_id to POST /api/v1/generation-tasks. The input field holds default form values you can reuse as-is or override in the task request.

Authorization

MagerApiKey
x-mager-api-key<token>

Mager API key

In: header

Query Parameters

page?number

Page number

limit?number

Limit per page

sort?string

Sort query

model?string

Filter templates by model slug from GET /api/v1/models. Example: advertisement

templateCategoryId?string

Filter templates by template category ID

Header Parameters

x-mager-api-key*string

Mager API key

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/templates" \  -H "x-mager-api-key: YOUR_API_KEY"
{  "status": 200,  "message": "Success",  "data": [    {      "template_id": "template_01hxyzready",      "model": "advertisement",      "model_title": "Advertisement Generator",      "capability": "IMAGE_GENERATION",      "description": "Ready-to-use product advertisement template",      "media_url": "https://cdn.example.com/template-preview.png",      "raw_prompt": {        "prompt": "Create a high-converting product advertisement"      },      "input": {        "productName": "Mager Matcha Latte",        "targetAudience": "Gen Z coffee shop customers",        "brandTone": "fresh, playful, premium"      },      "category": {        "id": "category_01hxyz",        "name": "Ads",        "slug": "ads"      },      "preview_results": [        {          "id": "preview_01hxyz",          "type": "image",          "media_url": "https://cdn.example.com/template-result.png",          "content_type": "image/png",          "filename": "template-result.png"        }      ],      "model_tiers": [        "lite",        "max"      ],      "usage_count": 42,      "created_at": "2026-07-03T06:00:00.000Z",      "updated_at": "2026-07-03T06:00:00.000Z"    }  ],  "pagination": {    "total": 1,    "nextPage": null,    "limit": 20,    "currentPage": 1,    "totalPage": 1  }}