Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cut.pro/docs/llms.txt

Use this file to discover all available pages before exploring further.

Depois de renderizar um clipe, você pode publicá-lo em uma ou mais contas conectadas com POST /posts. Um único post pode levar vários clipes para várias contas de uma vez.

​
Antes de começar

Você precisa de duas coisas:

Um clipe renderizado

O editId é o edit_setting_id que o render devolve quando concluído. É ele que identifica o vídeo a publicar.

Contas conectadas

O connectionId vem de GET /connections. Conecte novas contas pelo OAuth dentro de cut.pro — a API não conecta contas.

​
Como o corpo é montado

Cada item de videos aponta um clipe (editId) para um ou mais destinos (targets). Cada destino combina uma conexão (connectionId) com a metadata específica daquela plataforma (título, privacidade, etc.). 
curl -X POST https://api.cut.pro/api/v1/posts \
  -H "X-Api-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "editId": "EDIT_SETTING_ID",
        "targets": [
          {
            "connectionId": "CONEXAO_TIKTOK",
            "metadata": {
              "tiktok": {
                "title": "Meu corte viral",
                "privacyLevel": "PUBLIC_TO_EVERYONE"
              }
            }
          },
          {
            "connectionId": "CONEXAO_YOUTUBE",
            "metadata": {
              "youtube": {
                "title": "Meu corte viral",
                "description": "Cortes do episódio de hoje",
                "categoryId": "22",
                "privacyStatus": "public"
              }
            }
          }
        ]
      }
    ]
  }'
A metadata muda por plataforma (TikTok, YouTube, Instagram, Threads, Bluesky, LinkedIn, Pinterest, Facebook). Os campos obrigatórios e opções de cada uma estão detalhados na página do endpoint POST /posts, com o playground interativo.
Para agendar em vez de publicar agora, envie scheduled_at com uma data ISO 8601 no futuro.

​
Acompanhe a publicação

A resposta traz post_id, item_count e status (pending ou processing). Faça polling em GET /posts/{id}: 
curl https://api.cut.pro/api/v1/posts/POST_ID \
  -H "X-Api-Key: SUA_CHAVE"
O status do post evolui assim:
StatusSignificado
pendingNa fila, ainda não começou
processingPublicando nas contas
completedTodos os itens publicaram
partialAlguns publicaram, outros falharam
failedNenhum item publicou
O array items mostra o resultado por conta — útil quando o status é partial.

​
Quando algo falha

Itens falham de forma independente: um destino com erro não derruba os que já publicaram.
  • Reenviar um item que falhou: POST /posts/{id}/items/{itemId}/retry
  • Remover um item sem mexer nos demais: DELETE /posts/{id}/items/{itemId}
  • Apagar o post inteiro: DELETE /posts/{id}
  • Editar antes de publicar (ex.: ajustar agendamento): PATCH /posts/{id}
Last modified on June 1, 2026