Cut.ProDocs
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

  • "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  }}

Delete a post item DELETE

Removes a single `pending`, `rendering` or `failed` item from a post. A `rendering` item also aborts its render job when no other item still needs it. An item already `completed` is deleted from the destination network first, and only on networks that allow it. The network's refusal comes back as a `400` and nothing is removed here. An item in `publishing` is never removable: the media is already on its way. If the deletion empties the parent post, the post is also removed and `post_deleted: true` is returned.

Start an upload POST

Returns the generated `media_id` plus a presigned PUT URL. Upload the raw bytes to `upload_url` with the same `Content-Type` you declared here, then call `POST /transcriptions` with the `media_id` to start the job. Both video and audio files are accepted, so an audio-only podcast never has to be wrapped in a video container. The ceiling is the smaller of your plan's upload limit and the storage quota you still have free; `FILE_TOO_LARGE` reports the effective ceiling in `max_size` and `STORAGE_LIMIT_EXCEEDED` means the quota is full.