CutPro

Delete a persona Removes the persona and its videos from every listing. A generation still running finishes or is refunded as usual, and edits already created from its videos stay in the workspace.

delete_persona

Delete a post item Cancels a single `pending`, `rendering` or `failed` item so it never publishes. 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 changes here. An item in `publishing` cannot be cancelled: the media is already on its way. Cancelled items stop appearing in listings, and CutPro keeps the record. When nothing of the parent post is left, `post_deleted: true` is returned.

delete_post_item

Delete a transcription Removes the job from the list and from every read endpoint. The uploaded media stays in your library, so the same `media_id` can be transcribed again, and that re-run is a cache hit, not a second charge.

delete_transcription

Delete a video Permanently deletes a video from your library along with all its submissions and generated clips. This action cannot be undone. Submissions still processing are cancelled and their credits refunded.

delete_video

Delete submission Permanently deletes a submission and all its generated clips. This action cannot be undone. A submission still processing is cancelled and its credits refunded.

delete_submission

Download a clip's captions Returns the clip's captions as an SRT file or plain text. When the clip has an edit, its own captions are used (with any fix or translation made there); otherwise the source transcript cut to the clip. Timestamps start at `00:00`, lined up with the clip's own video, so the file can go straight next to the rendered MP4.

download_clip_subtitles

Download the transcript as a subtitle file Returns the transcript as a ready-to-use subtitle file (`srt` by default, `vtt` or `txt`) with the matching `Content-Type` and a `Content-Disposition` filename. The body is the file itself, not JSON. Speaker names are written into the file only when the job was billed with `speaker_labels`; pass `speakers=false` to leave them out of a diarized transcript. Returns `409 TRANSCRIPTION_NOT_READY` while the worker is still running. Keep polling `GET /transcriptions/{transcriptionId}`.

download_transcription

Generate an image or a video Generates one image or video with the chosen model from `GET /generations/models`, from a prompt alone or from images. Charges the credits at once; poll `GET /generations/{id}` every 10 seconds until it is `ready` or `failed`, which gives them back. `credits` is the total price the user agreed to: the model's `credits` for the mode and resolution, times `seconds` for a video (`silent_credits` with `audio: false`). A different current price answers `PRICE_CHANGED` with the new total and charges nothing. Always tell the user the model and the price and wait for their yes before calling this. `image_ids` come from `POST /generations/images` or from the `output.image_id` of a ready image: none for `text`, one for `image`, two (first, last) for `frames`, and up to the model's `max_images` for `references`.

create_generation

Get a connection Returns a single connection by ID, with the latest captured audience metrics.

get_connection

Get a generation Returns one generation. Poll it every 10 seconds while `status` is `processing`; `output.url` is set once `ready`.

get_generation

Get a monitored channel Returns one monitored channel and whether it is on. Monitoring can also turn itself off when the balance runs out.

get_monitor

Get a persona Returns the persona with its photo. Poll it every 5 seconds while `image_status` is `generating`.

get_persona

Get a persona photo Returns one persona photo. Poll it every 5 seconds while `status` is `processing`; `image_url` is set once `ready`.

get_persona_shot

Get a post Returns full status of a post including every item. Poll this endpoint to track immediate posts through `pending → rendering → publishing → completed`.

get_post

Get balance Returns your current credit balance. Credits are consumed each time you submit a video for clipping. When `unlimited` is true this workspace is on a courtesy plan: usage still shows up in the history with what it would have cost, but the balance does not move and jobs are never blocked for lack of credits.

get_balance

Get bulk download status Returns the current state of a bulk download job. Poll every 5–10 seconds until `status` is `completed`. Once complete, `download_url` is a signed URL valid for one hour; the underlying file is purged once `expires_at` passes.

get_bulk_download

Get credit history Returns the credit transaction ledger for this workspace, newest first. Each row shows the delta (`amount`, negative for debits), the resulting balance, and what caused it (`reference_type` + `reference_id`) so you can reconcile against submissions, renewals, refunds, and bonuses.

get_balance_history

Get current workspace Returns information about the workspace this request resolved to: name, plan, credit balance, member count and the role of the user who created the key. A key bound to one workspace always resolves to it. A key bound to several resolves to the one in the `X-Workspace-Id` header, so call this whenever you need to confirm which workspace a request is actually hitting.

get_workspace

Get render download URL Returns a time-limited signed URL to download the completed rendered video as an MP4. The URL expires after **1 hour** — fetch it fresh each time rather than caching it. Returns `410` if the file has been purged from storage (renders expire according to your plan's retention period).

download_render

Get render quota 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`.

get_render_limits

Get render status Returns the current status of a render job. Poll this endpoint until `status` is `completed` or `failed`. We recommend polling every **5–10 seconds**. Use `progress` (0–100) to display a progress bar to your users.

get_render

Get submission Returns the current status of a clipping submission. Poll this endpoint until `status` is `completed` or `failed`. We recommend polling every **5–10 seconds**. When `status` is `queued`, use `queue_position` and `estimated_time` to give feedback to your users. A submission can sit at `downloading` because the SOURCE is not fully published yet — a scheduled premiere, a livestream still on air, or a recording the platform is still processing. In that case `waiting_reason` is set (and `waiting_until` carries the announced start time, when the platform provides one). This is not an error and the submission is not stuck: it resumes on its own once the source becomes available. Surface it to your users instead of a generic "downloading", and offer them the option to cancel — `DELETE /v1/clips/{videoId}/submissions/{submissionId}` refunds the credits while `waiting_reason` is set.

get_submission

Get the link to connect an account A cut.pro link that opens the sign-in of that network right away, in this workspace. Give it to the user when the account they want to post to is missing from `GET /connections`; once they come back, list the connections again and carry on.

get_connection_link

Get the transcript as JSON Returns the transcript as timed cues, ready to render or index without parsing a subtitle file. Timings are in seconds from the start of the audio. `speaker` is only ever filled when the job was billed with `speaker_labels`; on every other job it is `null`. Returns `409 TRANSCRIPTION_NOT_READY` while the worker is still running. Keep polling `GET /transcriptions/{transcriptionId}`.

get_transcription_cues

Get traits, prices and limits Everything a client needs to build the persona form without hardcoding it: every trait option, the defaults, which traits still apply when reference photos are used, the prices in credits and the limits of a source video. Prices follow what the models cost and can change at any time, so read them from here.

get_persona_catalog

Get transcription status Returns the current state of a transcription job. Poll every **5–10 seconds** while `status` is `processing`. Once `status` is `ready`, fetch the text with `GET /transcriptions/{transcriptionId}/transcript` (JSON cues) or `GET /transcriptions/{transcriptionId}/download` (SRT, VTT or plain text).

get_transcription

List a persona's photos Returns the photos made with this persona, newest first, with signed image URLs for the finished ones.

list_persona_shots

List broadcasts of a live monitor Returns the channel's broadcasts, newest first, each with how many clips this workspace got from it. A broadcast with `ended_at: null` is on air and keeps producing clips every 10 minutes while the monitor is on. Only `live` monitors have broadcasts: a `video` monitor answers `400 INVALID_OBSERVING_TYPE`, and its clips arrive as regular submissions in `GET /clips`.

list_broadcasts

List clips of a broadcast Returns the clips this workspace got from one broadcast, best rated first by default. While the broadcast is on air, new clips land every 10 minutes, so poll this list rather than waiting for the broadcast to end. A clip with an `edit_id` is ready to render or post; one without it renders with the default layout through `POST /monitors/{id}/broadcasts/{broadcastId}/clips/{clipId}/render`. Returns `410` once the recording was purged.

list_broadcast_clips

List connections Returns the active social connections in this workspace — the IDs you pass as `connection_id` when creating a post. Each entry includes the platform, public profile info (username, avatar, bio) and the latest captured audience metrics (followers, posts, likes). Revoked or disconnected accounts are excluded.

list_connections

List generated clips Returns the AI-generated highlight clips produced by a completed submission. Each clip includes its timestamp range within the source video, an AI relevance score, and signed URLs for streaming and downloading. Sort by `rating` (default) to surface the most impactful clips first. Download and play URLs are time-limited signed URLs — fetch them fresh when needed rather than caching them long-term. Returns `410` if the submission has expired. Re-submit the video to generate new clips.

list_clips

List generations The workspace's images and videos generated with `POST /generations`, newest first.

list_generations

List image and video models and their prices Every image and video model CutPro generates with right now (Veo, Kling, Seedance, Wan, Nano Banana, GPT Image and more), with the modes, resolutions, durations and aspect ratios each one accepts and its price in credits. Prices follow what the models cost and can change at any time, so read them from here before `POST /generations`. When the user names no model, use `presets`: the recommended model for each quality level.

list_generation_models

List monitored channels Returns the channels this workspace monitors, with whether each one is on right now and the settings its clips use.

list_monitors

List personas Returns the workspace's personas, newest first, drafts included. `image_status` and `video_generating` say what is still being generated, so one call shows every persona in progress.

list_personas

List posts Returns a paginated list of posts in this workspace, newest first. Each post includes its items with current status and error codes.

list_posts

List ready-made characters Characters whose photo already exists. `POST /personas/presets/{presetId}` turns one into a persona for free, ready to name, save and use in videos. `favorite` is the key's user's star, set with `PUT /personas/presets/{presetId}/favorite`.

list_persona_presets

List renders Returns a paginated list of all your render jobs, newest first. Filter by `status` to focus on processing, completed, or failed renders.

list_renders

List submissions Returns a paginated list of all clipping submissions for a video, newest first. Use this to audit past runs, find a specific submission ID, or check whether a job is still in progress.

list_submissions

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.

list_templates