JsonCutDocs
V2 APIEndpointsTemplates

Preflight and queue a bounded JSON or CSV batch pinned to one template version

Preflight and queue a bounded JSON or CSV batch pinned to one template version. Published, version-pinned projects with typed inputs for repeatable image and video generation. Required API key scopes: `templates:bulk`.

POST
/api/v2/templates/{id}/bulk-renders

Authorization

apiKeyAuth

Path Parameters

id*string

Resource identifier

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/templates/string/bulk-renders" \  -H "Content-Type: application/json" \  -d '{    "idempotencyKey": "campaign-2026-08",    "csv": "title\\nFirst launch\\nSecond launch",    "output": {      "kind": "image",      "format": "png",      "transparent": true    }  }'
{  "success": true,  "data": {    "id": "bulk_01J",    "templateId": "template_01J",    "templateVersion": 2,    "status": "running",    "totalItems": 100,    "validItems": 100,    "completedItems": 42,    "failedItems": 0,    "createdAt": "2026-08-25T09:20:00.000Z",    "updatedAt": "2026-08-25T09:22:00.000Z"  }}