# Cut.Pro

> Documentação do cut.pro

## Docs

- [Visão geral da API](https://cut.pro/docs/api-reference/introducao.md): Automatize a clipagem e renderização de vídeos com IA, de forma programática
- [Autenticação](https://cut.pro/docs/api-reference/autenticacao.md): Como autenticar suas requisições e selecionar o workspace
- [Quickstart: seu primeiro clipe](https://cut.pro/docs/api-reference/quickstart.md): Do link do vídeo ao MP4 renderizado, com requisições reais
- [Limites de requisição](https://cut.pro/docs/api-reference/rate-limit.md): Como funciona o rate limit da API e como lidar com o status 429
- [Conectar via MCP](https://cut.pro/docs/api-reference/mcp.md): Use o CutPro dentro do Claude, ChatGPT e outras ferramentas de IA via Model Context Protocol
- [Workspace e créditos](https://cut.pro/docs/api-reference/saldo.md): Como o workspace, o plano e o saldo de créditos funcionam na API
- [Get current workspace](https://cut.pro/docs/api-reference/workspace/get-current-workspace.md): Returns information about the workspace this API key represents — name, plan, credit balance, member count and the role of the user who created the key. Each API key is bound to a single workspace; to operate on a different workspace, create a separate key from inside that workspace.
- [Get balance](https://cut.pro/docs/api-reference/balance/get-balance.md): 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 c…
- [Get credit history](https://cut.pro/docs/api-reference/balance/get-credit-history.md): 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.
- [Enviando um vídeo para clipagem](https://cut.pro/docs/api-reference/enviando-video.md): As duas formas de obter um video_id: por URL pública ou enviando seu próprio arquivo
- [List videos](https://cut.pro/docs/api-reference/videos/list-videos.md): Returns a paginated list of all source videos in your library, ordered by most recent submission. Each item includes lifecycle counters (clips generated, edits, exports, posts) and the status of the latest submission.
- [Start an upload](https://cut.pro/docs/api-reference/videos/start-an-upload.md): Returns the generated `video_id` plus whatever the file's size requires to upload it directly to storage, then call `POST /videos/upload/complete` to register the upload and get the credit cost.
- [Complete an upload](https://cut.pro/docs/api-reference/videos/complete-an-upload.md): Registers a finished upload, captures its dimensions/duration, and returns the video metadata together with the exact credit cost — same payload shape as `POST /clips/info`. Pass the returned `video_id` to `POST /clips` to start a clipping submission.
- [Delete a video](https://cut.pro/docs/api-reference/videos/delete-a-video.md): Permanently deletes a video from your library along with all its submissions and generated clips. This action cannot be undone. Returns `409` if a submission is currently processing.
- [Analyze a video](https://cut.pro/docs/api-reference/submissions/analyze-a-video.md): Fetches metadata for a public video URL and calculates the exact credit cost before you commit to clipping. No credits are charged. Use this as a pre-flight check before calling `POST /clips`.
- [Submit a video for clipping](https://cut.pro/docs/api-reference/submissions/submit-a-video-for-clipping.md): Queues a video for AI clipping. Credits are deducted immediately upon submission. Returns a `submission_id` to track progress.
- [List submissions](https://cut.pro/docs/api-reference/submissions/list-submissions.md): 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.
- [Get submission](https://cut.pro/docs/api-reference/submissions/get-submission.md): Returns the current status of a clipping submission. Poll this endpoint until `status` is `completed` or `failed`.
- [Delete submission](https://cut.pro/docs/api-reference/submissions/delete-submission.md): Permanently deletes a submission and all its generated clips. This action cannot be undone. Returns `409` if the submission is currently processing — wait for it to complete or fail first.
- [List generated clips](https://cut.pro/docs/api-reference/clips/list-generated-clips.md): 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.
- [Apply template to clips](https://cut.pro/docs/api-reference/clips/apply-template-to-clips.md): Asynchronously applies one of your saved templates to all (or a subset of) the generated clips in a submission. The job runs in the background — returns immediately with the number of clips being processed.
- [Delete a clip](https://cut.pro/docs/api-reference/clips/delete-a-clip.md): Permanently deletes a single generated clip. This action cannot be undone.
- [List templates](https://cut.pro/docs/api-reference/templates/list-templates.md): 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.
- [Render a clip](https://cut.pro/docs/api-reference/renders/render-a-clip.md): Queues a clip for video rendering. Returns a `render_id` you can use to poll status via `GET /renders/{renderId}`.
- [List renders](https://cut.pro/docs/api-reference/renders/list-renders.md): Returns a paginated list of all your render jobs, newest first. Filter by `status` to focus on processing, completed, or failed renders.
- [Get render status](https://cut.pro/docs/api-reference/renders/get-render-status.md): Returns the current status of a render job. Poll this endpoint until `status` is `completed` or `failed`.
- [Get render download URL](https://cut.pro/docs/api-reference/renders/get-render-download-url.md): 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.
- [Get render quota](https://cut.pro/docs/api-reference/renders/get-render-quota.md): 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`.
- [Start a bulk download](https://cut.pro/docs/api-reference/renders/start-a-bulk-download.md): Packages a set of completed renders into a single zip file. Returns a `job_id` immediately — poll `GET /renders/bulk-download/{job_id}` until `status` is `completed`, then download the zip from the returned URL.
- [Get bulk download status](https://cut.pro/docs/api-reference/renders/get-bulk-download-status.md): 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.
- [Cancel or delete a render](https://cut.pro/docs/api-reference/renders/cancel-or-delete-a-render.md): Cancels a queued or active render, or permanently deletes a completed/failed/expired render record. Deleting a completed render also removes the rendered video file from storage.
- [Publicando nas redes](https://cut.pro/docs/api-reference/postagem.md): Como publicar clipes renderizados no TikTok, Instagram, YouTube e mais
- [Create a post](https://cut.pro/docs/api-reference/posts/create-a-post.md): Creates a multi-platform post for one or more edited clips. Each entry under `videos` references an `edit_id` (the rendered or apply_template'd clip) plus a list of target connections with platform-specific metadata.
- [List posts](https://cut.pro/docs/api-reference/posts/list-posts.md): Returns a paginated list of posts in this workspace, newest first. Each post includes its items with current status and error codes.
- [Get a post](https://cut.pro/docs/api-reference/posts/get-a-post.md): Returns full status of a post including every item. Poll this endpoint to track immediate posts through `pending → rendering → publishing → published`.
- [Update a post](https://cut.pro/docs/api-reference/posts/update-a-post.md): Updates a post that is still pending. Two things can change:
- [Trigger publish](https://cut.pro/docs/api-reference/posts/trigger-publish.md): Forces the publishing pipeline to run for a post that is currently `pending`, `failed`, or stuck. Useful for scheduled posts you want to publish early, or to nudge a post whose worker missed its window.
- [Retry a failed item](https://cut.pro/docs/api-reference/posts/retry-a-failed-item.md): Re-queues a `failed` item for publishing. The item's `Error` and previous `render_id` are cleared. Only items currently in `failed` state can be retried.
- [Delete a post item](https://cut.pro/docs/api-reference/posts/delete-a-post-item.md): 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. Items already `publishing` or `completed` cannot be removed (the media is on its way to, or already on, the destination platform). If the deletion em…
- [Delete a post](https://cut.pro/docs/api-reference/posts/delete-a-post.md): Permanently deletes a post and all its items. Already-published items remain live on the destination platforms — this only removes the CutPro record.
- [List connections](https://cut.pro/docs/api-reference/connections/list-connections.md): 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 e…
- [Get a connection](https://cut.pro/docs/api-reference/connections/get-a-connection.md): Returns a single connection by ID, with the latest captured audience metrics.

## OpenAPI Specs

- [openapi](https://cut.pro/docs/openapi.json)