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 devideos 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.).
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.
Acompanhe a publicação
A resposta trazpost_id, item_count e status (pending ou processing). Faça polling em GET /posts/{id}:
status do post evolui assim:
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}