Cut.ProDocs
Editing: templates

List templates

Returns a paginated list of video editing templates. Use filter=mine (default) to list your own templates, or filter=public for CutPro's built-in public templates.

Pass a template's id to POST /clips/{videoId}/submissions/{submissionId}/apply_template to apply it in bulk to your generated clips.

Authorization

apiKey
X-Api-Key<token>

In: header

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100
filter?string

Value in

  • "mine"
  • "public"
sort?string

Value in

  • "recent"
  • "most_recent"
  • "name"

Response Body

application/json

GET
/templates
curl -X GET "https://example.com/templates"
{  "templates": [    {      "id": "string",      "name": "string",      "description": "string",      "category": "string",      "aspect_ratio": "string",      "auto_add_captions": true,      "is_public": true,      "thumbnail_url": "string",      "created_at": "string"    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}

Render a broadcast clip POST

Queues a live clip for rendering and returns the render `id` to poll with `GET /renders/{renderId}`. The clip renders with its template when one was applied, otherwise with the default layout. If an identical render is already in storage, returns `200` with `from_cache: true` and a ready `download_url`; `409` if the same clip is already rendering.

Get render quota GET

Returns the workspace's current render usage and plan-level render limits. Use this before kicking off a render to avoid being throttled — if `usage.total_pending >= usage.max_concurrent`, a new render will be rejected with `429`.