# PostClean Docs - [Início](https://docs.postclean.com.br/index.md): Documentação do PostClean: planeje, agende e publique posts em 13 redes sociais. - [Primeiros passos](https://docs.postclean.com.br/getting-started/quickstart.md): Crie sua conta, conecte um canal e agende o primeiro post no PostClean - [Instagram](https://docs.postclean.com.br/platforms/instagram.md): Conecte uma conta Empresa ou Criador de conteúdo do Instagram ao PostClean - [Facebook](https://docs.postclean.com.br/platforms/facebook.md): Conecte suas páginas do Facebook ao PostClean - [LinkedIn](https://docs.postclean.com.br/platforms/linkedin.md): Conecte seu perfil ou as páginas da sua empresa no LinkedIn ao PostClean - [X (Twitter)](https://docs.postclean.com.br/platforms/x-twitter.md): Conecte sua conta do X (antigo Twitter) ao PostClean - [TikTok](https://docs.postclean.com.br/platforms/tiktok.md): Conecte sua conta do TikTok ao PostClean - [YouTube](https://docs.postclean.com.br/platforms/youtube.md): Conecte seu canal do YouTube ao PostClean - [Threads](https://docs.postclean.com.br/platforms/threads.md): Conecte sua conta do Threads ao PostClean - [Pinterest](https://docs.postclean.com.br/platforms/pinterest.md): Conecte sua conta do Pinterest ao PostClean - [Bluesky](https://docs.postclean.com.br/platforms/bluesky.md): Conecte sua conta do Bluesky ao PostClean - [Mastodon](https://docs.postclean.com.br/platforms/mastodon.md): Conecte sua conta do Mastodon ao PostClean - [Telegram](https://docs.postclean.com.br/platforms/telegram.md): Conecte um canal ou grupo do Telegram ao PostClean - [Discord](https://docs.postclean.com.br/platforms/discord.md): Conecte um servidor do Discord ao PostClean e publique nos canais dele - [Google Business Profile](https://docs.postclean.com.br/platforms/google-business.md): Conecte um local do Google Business Profile ao PostClean e publique posts nele. - [Suporte](https://docs.postclean.com.br/support.md): Fale com o suporte do PostClean por e-mail - [Introdução](https://docs.postclean.com.br/api-reference/introduction.md): Autentique com uma chave de API do workspace e chame a API REST do PostClean: URL base, permissões, erros, paginação e limites de requisições. - [Publicação](https://docs.postclean.com.br/api-reference/guides/posting.md): Crie, agende e publique posts pela API: destinos, configurações por rede, modos de agendamento, respostas em fio e limites de conteúdo. - [Envio de mídia](https://docs.postclean.com.br/api-reference/guides/media-uploads.md): Anexe imagens, vídeos e PDFs a posts pela API: envie um arquivo, anexe a partir de uma URL ou reutilize a mídia de outro post. - [Listar posts](https://docs.postclean.com.br/api-reference/posts/list-posts.md): Lista os posts do workspace com seus destinos e etiquetas, incluindo os importados da rede. Primeiro vêm os posts sem horário, depois os agendados, do horário mais distante para o mais próximo (empates pelo mais recente). Quem pode aprovar vê os pedidos de aprovação de todos os membros; quem precisa… - [Criar post](https://docs.postclean.com.br/api-reference/posts/create-post.md): Cria um post em uma conta social. A conta, o formato e as configurações da rede vão em `platforms`, que precisa ter exatamente um item. Para o mesmo texto em vários canais, use `POST /posts/batch`. - [Criar posts em lote](https://docs.postclean.com.br/api-reference/posts/create-posts-in-batch.md): Cria um post independente para cada destino, como o app faz quando vários canais são escolhidos. Os posts compartilham o mesmo `post_group_id`. Cada destino pode trocar o `content` e a `media` compartilhados e ter seu próprio `content_type` e `meta`. - [Ver post](https://docs.postclean.com.br/api-reference/posts/get-post.md): Retorna um post com seus destinos e etiquetas. Um pedido de aprovação de outro membro, visto por quem não pode aprová-lo, responde `404`. - [Atualizar post](https://docs.postclean.com.br/api-reference/posts/update-post.md): Atualiza um post. Só os campos enviados mudam. A conta social do post não muda (`social_account_id` é recusado). - [Excluir post](https://docs.postclean.com.br/api-reference/posts/delete-post.md): Exclui um post que ainda não foi enviado, com suas mídias. Nada é apagado na rede. Um membro que precisa de aprovação só exclui os próprios posts (ou os pedidos de aprovação que ele fez), senão recebe `403`. Posts que estão publicando, publicados, parcialmente publicados ou com falha não podem ser e… - [Ver métricas do post](https://docs.postclean.com.br/api-reference/posts/get-post-metrics.md): Retorna as métricas salvas de cada destino ativo do post: o último retrato diário que o PostClean coletou da rede. Nenhuma chamada é feita à rede. LinkedIn, Página do LinkedIn, Telegram, Discord e Google Business não entram nas análises. - [Ver prévia do post](https://docs.postclean.com.br/api-reference/posts/get-post-preview.md): Mostra, para cada destino ativo, o texto que a rede vai receber depois das regras de formatação dela e o tamanho dele frente ao limite da conta. Nada é publicado. - [Listar notas do post](https://docs.postclean.com.br/api-reference/post-notes/list-post-notes.md): Lista as notas do post, da mais nova para a mais antiga. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar nota no post](https://docs.postclean.com.br/api-reference/post-notes/create-post-note.md): Adiciona uma nota interna ao post, em nome do usuário da chave de API. Notas nunca são publicadas. Os outros membros do workspace recebem um e-mail sobre ela (a não ser que tenham desligado esse aviso nas preferências de notificação); num post aguardando aprovação, só os aprovadores e quem pediu a a… - [Atualizar nota do post](https://docs.postclean.com.br/api-reference/post-notes/update-post-note.md): Troca o texto de uma nota. Só quem escreveu a nota pode editá-la (senão, `403` com `This action is unauthorized.`). Uma nota de outro post responde `404`. - [Excluir nota do post](https://docs.postclean.com.br/api-reference/post-notes/delete-post-note.md): Exclui uma nota. Só quem escreveu a nota pode excluí-la (senão, `403` com `This action is unauthorized.`). Uma nota de outro post responde `404`. - [Aprovar post](https://docs.postclean.com.br/api-reference/approvals/approve-post.md): Aprova um post que aguarda aprovação (`pending_approval`). Com o corpo vazio, o post é agendado como foi pedido: na posição da fila ou no horário que o membro escolheu. Mande `scheduled_at` para escolher outro horário, ou `publish_now: true` para publicar agora. - [Rejeitar post](https://docs.postclean.com.br/api-reference/approvals/reject-post.md): Rejeita um post que aguarda aprovação. O post volta para `draft` e o horário pedido fica no rascunho; nenhum motivo é guardado. Quem pediu a aprovação recebe um e-mail com a decisão. Um post que não aguarda mais aprovação responde `422` em `post`. Não há corpo. - [Definir repetição do post](https://docs.postclean.com.br/api-reference/recurrence/set-post-recurrence.md): Faz um post agendado se repetir: a cada `interval` `frequency`, mais `times` vezes depois desta. Cada ocorrência mantém o mesmo horário local no fuso do canal. Uma regra nova substitui a anterior. O post precisa estar `scheduled` com horário, senão `422` em `post`: `Só posts agendados podem se repet… - [Remover repetição do post](https://docs.postclean.com.br/api-reference/recurrence/remove-post-recurrence.md): Faz o post parar de se repetir. O post e o próximo horário agendado continuam. Num post sem repetição, nada muda. - [Enviar mídia](https://docs.postclean.com.br/api-reference/media-and-uploads/upload-media.md): Envia um arquivo como `multipart/form-data` no campo `media` e o adiciona ao fim das mídias do post. Arquivos aceitos: imagens JPEG, PNG, GIF e WebP (também HEIC e HEIF quando o servidor consegue convertê-los, e nesse caso são salvos como JPEG), vídeos MP4 e MOV e documentos PDF. Limites de tamanho:… - [Anexar mídia de um upload](https://docs.postclean.com.br/api-reference/media-and-uploads/attach-media-from-upload.md): Adiciona ao fim das mídias do post um arquivo enviado antes (`POST /uploads` ou uma URL assinada). O post guarda uma cópia própria do arquivo e o token é consumido. Um token desconhecido ou expirado (uploads valem 24 horas) falha com `422` em `upload_token`: `Este envio expirou. Adicione o arquivo n… - [Anexar mídia por URL](https://docs.postclean.com.br/api-reference/media-and-uploads/attach-media-from-url.md): Baixa até 10 arquivos públicos e os adiciona ao fim das mídias do post. Cada URL precisa entregar o próprio arquivo: redirecionamentos não são seguidos, e páginas web, hosts de rede privada e arquivos acima do limite do tipo são recusados. Cada download tem até 20 segundos. Só são aceitos os tipos d… - [Criar upload](https://docs.postclean.com.br/api-reference/media-and-uploads/create-upload.md): Envia um arquivo como `multipart/form-data` no campo `media`, sem post, e devolve um `upload_token`. Passe o token como item de mídia (`media[].upload_token`) em `POST /posts`, `POST /posts/batch` ou `PUT /posts/{post}`, ou em `POST /posts/{post}/media/from-upload`, antes de `expires_at`. O primeiro… - [Enviar para URL assinada](https://docs.postclean.com.br/api-reference/media-and-uploads/upload-to-signed-url.md): Recebe um arquivo numa URL assinada de uso único, gerada pela ferramenta MCP `request-media-upload-tool`. Não usa chave de API: a assinatura autoriza o pedido. Envie o arquivo como `multipart/form-data` no campo `media`, por exemplo `curl -F media=@lancamento.jpg ""`. A URL funciona uma… - [Listar contas sociais](https://docs.postclean.com.br/api-reference/social-accounts/list-social-accounts.md): Lista as contas sociais (canais) conectadas ao workspace. As contas são conectadas, reconectadas e removidas no app; a API não consegue alterá-las. `max_content_length` é o limite de texto de cada conta (uma conta do X com posts longos tem 25000). O tamanho da página é definido pelo servidor: leia `… - [Listar pastas do Pinterest](https://docs.postclean.com.br/api-reference/social-accounts/list-pinterest-boards.md): Lista as pastas de uma conta do Pinterest, lidas na hora no Pinterest. Use o `id` de uma pasta como `platforms[].meta.board_id` num destino do Pinterest. `truncated` vem `true` quando o PostClean não conseguiu ler todas as páginas de pastas do Pinterest. Este endpoint também conta para um limite de… - [Criar pasta do Pinterest](https://docs.postclean.com.br/api-reference/social-accounts/create-pinterest-board.md): Cria uma pasta numa conta do Pinterest. Os espaços nas pontas do nome são removidos. Quando o Pinterest recusa (conexão expirada, permissão, limite ou qualquer outro erro), a requisição retorna `422` com o motivo em `name`. Este endpoint também conta para um limite de 60 requisições por minuto por u… - [Listar canais do Discord](https://docs.postclean.com.br/api-reference/social-accounts/list-discord-channels.md): Lista os canais do servidor de uma conta do Discord em que o bot do PostClean pode postar, lidos no Discord e guardados por 5 minutos por servidor. Use o `id` de um canal como `platforms[].meta.channel_id` num destino do Discord. Este endpoint também conta para um limite de 60 requisições por minuto… - [Ver dados de criador do TikTok](https://docs.postclean.com.br/api-reference/social-accounts/get-tiktok-creator-info.md): Lê o que o TikTok permite que este criador publique agora: os níveis de privacidade que podem ir em `platforms[].meta.privacy_level`, se comentários, duetos e costuras estão desligados e a duração máxima de vídeo. Um criador que o TikTok não deixa postar no momento volta com `can_post: false`. Respo… - [Ver horários de postagem](https://docs.postclean.com.br/api-reference/channels/get-posting-schedule.md): Retorna o fuso horário do canal, a meta semanal de posts e os horários de postagem. Os horários da fila (`queue: next|top`, `queue_slot`) saem desses horários, no fuso do canal. - [Atualizar horários de postagem](https://docs.postclean.com.br/api-reference/channels/update-posting-schedule.md): Substitui o fuso horário, a meta de posts e os horários de postagem do canal. Envie os sete dias, ou `posting_schedule: null` para remover todos os horários. Todos os campos são gravados: omitir `posting_goal` ou `posting_schedule` limpa o campo como `null`, então envie os valores atuais para mantê-… - [Gerar horários de postagem](https://docs.postclean.com.br/api-reference/channels/generate-posting-schedule.md): Substitui os horários de postagem do canal por `goal` horários por semana, nas horas que costumam funcionar melhor na rede dele (os minutos são sorteados), e grava `goal` como meta de posts. Sem `goal`, vale a meta atual do canal, ou 3 se não houver. O fuso horário não muda. Todos os dias ficam ativ… - [Copiar horários de postagem](https://docs.postclean.com.br/api-reference/channels/copy-posting-schedule.md): Copia para este canal os horários de postagem de outro canal do workspace. O fuso horário e a meta de posts deste canal não mudam. Uma origem com `posting_schedule` `null` retorna `422` em `from`. Uma origem com horários vazios é copiada assim mesmo, o que remove os horários deste canal. Os posts da… - [Listar horários livres da fila](https://docs.postclean.com.br/api-reference/channels/list-free-queue-slots.md): Lista os próximos horários livres da fila do canal, do mais próximo para o mais distante: no máximo 30, dentro dos próximos 90 dias e a mais de um minuto de agora. Um horário está ocupado quando um post agendado (da fila ou com horário personalizado) ou um pedido de fila aguardando aprovação está ne… - [Reordenar a fila](https://docs.postclean.com.br/api-reference/channels/reorder-queue.md): Reordena os primeiros posts da fila do canal. Envie os ids dos N primeiros posts da fila (agendados no modo fila, a mais de um minuto de agora, em ordem de horário) na nova ordem: os posts trocam entre si os horários que já ocupam, e os posts depois dos N primeiros ficam onde estão. Quando os ids nã… - [Mover post para um horário da fila](https://docs.postclean.com.br/api-reference/channels/move-post-to-queue-slot.md): Move um post agendado deste canal (da fila ou com horário personalizado) para um dos horários livres do canal, como post da fila. Pegue `slot_at` em `GET /channels/{account}/queue/slots`. Um horário ocupado, fora dos horários de postagem, a mais de 90 dias ou reservado por um pedido pendente retorna… - [Listar ideias](https://docs.postclean.com.br/api-reference/ideas/list-ideas.md): Lista as ideias do workspace, das mais novas para as mais antigas, com mídias e etiquetas. Os filtros de etapa (`stages[]`, `unassigned`) trazem as ideias que se encaixam em qualquer um deles, e os filtros de etiqueta (`labels[]`, `untagged`) funcionam do mesmo jeito. Os dois grupos se combinam com… - [Criar ideia](https://docs.postclean.com.br/api-reference/ideas/create-idea.md): Cria uma ideia no fim da etapa dela. A ideia precisa de título, texto ou mídia: uma ideia vazia retorna `422` em `title`. Pela API não é possível transformar ideias em posts. - [Excluir ideias](https://docs.postclean.com.br/api-reference/ideas/delete-ideas.md): Exclui várias ideias e as mídias delas. Ids que não são ideias deste workspace são ignorados. - [Ver ideia](https://docs.postclean.com.br/api-reference/ideas/get-idea.md): Retorna uma ideia com as mídias e etiquetas dela. - [Atualizar ideia](https://docs.postclean.com.br/api-reference/ideas/update-idea.md): Altera só os campos enviados. `media_ids` e `label_ids` substituem a lista inteira. Mudar a ideia de etapa com `idea_stage_id` coloca a ideia no fim da nova etapa. A ideia precisa continuar com título, texto ou mídia. - [Excluir ideia](https://docs.postclean.com.br/api-reference/ideas/delete-idea.md): Exclui uma ideia e as mídias dela. - [Duplicar ideia](https://docs.postclean.com.br/api-reference/ideas/duplicate-idea.md): Copia uma ideia logo depois da original, na mesma etapa, com uma cópia própria das mídias e as mesmas etiquetas. - [Mover ideia](https://docs.postclean.com.br/api-reference/ideas/move-idea.md): Move uma ideia para uma etapa (ou para Sem etapa, com `idea_stage_id: null`) e define a ordem dessa etapa. `idea_ids` é a ordem completa da etapa de destino depois da mudança: todas as ideias que já estão nela mais a ideia movida, cada uma uma vez. Se a lista não bater com as ideias da etapa (alguém… - [Listar etapas de ideias](https://docs.postclean.com.br/api-reference/idea-stages/list-idea-stages.md): Lista todas as etapas (colunas) do quadro de ideias, na ordem do quadro, com `ideas_count`. Sem paginação: o corpo é um array simples. - [Criar etapa de ideias](https://docs.postclean.com.br/api-reference/idea-stages/create-idea-stage.md): Adiciona uma etapa no fim do quadro. - [Reordenar etapas de ideias](https://docs.postclean.com.br/api-reference/idea-stages/reorder-idea-stages.md): Define a ordem do quadro. Envie os ids de todas as etapas do workspace, cada um uma vez, na nova ordem. Uma lista que não bate com as etapas atuais retorna `422` em `stage_ids`. - [Atualizar etapa de ideias](https://docs.postclean.com.br/api-reference/idea-stages/update-idea-stage.md): Renomeia uma etapa. - [Excluir etapa de ideias](https://docs.postclean.com.br/api-reference/idea-stages/delete-idea-stage.md): Exclui uma etapa. As ideias dela não são excluídas: vão para o fim de Sem etapa, na mesma ordem. - [Ver métricas do workspace](https://docs.postclean.com.br/api-reference/analytics/get-workspace-analytics.md): Retorna o relatório de análises do workspace para um período, comparado com o período anterior de mesmo tamanho: resumo, seguidores, posts por intervalo, melhores posts, desempenho por canal e cobertura da coleta. Os dias são dias corridos no fuso horário do usuário dono da chave de API (Ajustes, Pr… - [Ver métricas de uma publicação](https://docs.postclean.com.br/api-reference/analytics/get-publication-analytics.md): Retorna as análises mais recentes já salvas de uma publicação: um post publicado pelo PostClean ou encontrado num canal conectado. Pegue o id em `top_posts` de `GET /analytics` ou em `GET /channels/{account}/insights/publications`. Uma publicação apagada na rede ou indisponível, de outro workspace o… - [Ver insights do canal](https://docs.postclean.com.br/api-reference/analytics/get-channel-insights.md): Retorna os insights de um canal para um período: as métricas que ele informa, o resumo e as séries de métricas do período e do período anterior. Os dias são dias corridos no fuso horário do usuário dono da chave de API. Etiquetas, `untagged` e tipos filtram as métricas de posts; os seguidores contin… - [Listar desempenho dos posts do canal](https://docs.postclean.com.br/api-reference/analytics/list-channel-post-performance.md): Classifica os posts do canal no período (feitos no PostClean ou não) por uma métrica, do melhor para o pior, e retorna os 50 primeiros, uma página por vez. O tamanho da página é definido pelo servidor: leia `meta.per_page`. A resposta também traz os `filters` que o servidor aplicou. Posts sem a métr… - [Listar etiquetas](https://docs.postclean.com.br/api-reference/labels/list-labels.md): Lista as etiquetas do workspace, das mais novas para as mais antigas. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar etiqueta](https://docs.postclean.com.br/api-reference/labels/create-label.md): Cria uma etiqueta. Para usá-la em posts e ideias, envie o id dela em `label_ids`. - [Atualizar etiqueta](https://docs.postclean.com.br/api-reference/labels/update-label.md): Renomeia uma etiqueta ou muda a cor dela. Envie os dois campos. - [Excluir etiqueta](https://docs.postclean.com.br/api-reference/labels/delete-label.md): Exclui uma etiqueta. Ela deixa de aparecer nos posts e nas ideias. - [Listar assinaturas](https://docs.postclean.com.br/api-reference/signatures/list-signatures.md): Lista as assinaturas do workspace, das mais novas para as mais antigas. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar assinatura](https://docs.postclean.com.br/api-reference/signatures/create-signature.md): Cria uma assinatura: um texto reutilizável que os membros podem inserir no editor de posts. A assinatura nunca é adicionada aos posts automaticamente, nem nos posts criados pela API. - [Atualizar assinatura](https://docs.postclean.com.br/api-reference/signatures/update-signature.md): Altera o nome e o texto de uma assinatura. Envie os dois campos. - [Excluir assinatura](https://docs.postclean.com.br/api-reference/signatures/delete-signature.md): Exclui uma assinatura. Os posts que já têm o texto dela continuam com ele. - [Ver workspace](https://docs.postclean.com.br/api-reference/workspace/get-workspace.md): Retorna o workspace ao qual a chave de API pertence e, em `me`, o que o usuário da chave pode fazer nele. Só administradores usam chaves de API, então `me.is_admin` é `true` e os posts enviados pela API nunca aguardam aprovação. - [Listar chaves de API](https://docs.postclean.com.br/api-reference/api-keys/list-api-keys.md): Lista as suas chaves de API deste workspace que não foram excluídas, das mais novas para as mais antigas. Chaves de outros membros não aparecem. O segredo da chave nunca é retornado de novo. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar chave de API](https://docs.postclean.com.br/api-reference/api-keys/create-api-key.md): Cria uma chave de API para você neste workspace. `plain_token` é a chave: ela aparece só nesta resposta, então guarde agora. Com `expires_at`, a chave para de funcionar no fim desse dia (UTC); sem ele, a chave nunca expira. - [Excluir chave de API](https://docs.postclean.com.br/api-reference/api-keys/delete-api-key.md): Revoga uma das suas chaves de API deste workspace. As integrações que usam a chave param de funcionar na hora. Uma chave de outro membro ou de outro workspace retorna `404`. É possível revogar a própria chave usada na chamada. - [Listar webhooks](https://docs.postclean.com.br/api-reference/webhooks/list-webhooks.md): Lista os webhooks do workspace, dos mais novos para os mais antigos. O segredo de assinatura não vem na lista: consulte com `GET /webhooks/{webhook}`. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar webhook](https://docs.postclean.com.br/api-reference/webhooks/create-webhook.md): Cria um webhook ativo que envia os eventos de post escolhidos para o seu endpoint. A resposta traz o `signing_secret`. O endpoint precisa ser uma URL pública `http` ou `https`: outros esquemas e endereços privados ou locais são recusados com `422` em `endpoint` (mensagem `Este endpoint não é permiti… - [Ver webhook](https://docs.postclean.com.br/api-reference/webhooks/get-webhook.md): Retorna um webhook, com o `signing_secret`. - [Atualizar webhook](https://docs.postclean.com.br/api-reference/webhooks/update-webhook.md): Altera só os campos enviados. `status` aceita `enabled` ou `disabled` (`paused` só o PostClean define). Ativar um webhook desativado ou pausado zera `consecutive_failures` e `paused_at`. Um novo endpoint que não seja uma URL pública `http` ou `https` retorna `422` em `endpoint`. O segredo de assinat… - [Excluir webhook](https://docs.postclean.com.br/api-reference/webhooks/delete-webhook.md): Exclui um webhook e os registros de entrega dele. As entregas que já estavam na fila são descartadas. - [Listar registros do webhook](https://docs.postclean.com.br/api-reference/webhooks/list-webhook-logs.md): Lista as entregas do webhook, das mais novas para as mais antigas, com o corpo enviado e a resposta do endpoint. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Reenviar entrega do webhook](https://docs.postclean.com.br/api-reference/webhooks/replay-webhook-log.md): Envia de novo o `data` de uma entrega anterior, em segundo plano, mesmo com o webhook desativado ou pausado. O reenvio é uma nova entrega: tem registro próprio, novos `id` e `created_at` no corpo e é assinado com o segredo atual. Um registro de outro webhook retorna `404`. - [Trocar segredo do webhook](https://docs.postclean.com.br/api-reference/webhooks/rotate-webhook-secret.md): Troca o segredo de assinatura do webhook. A partir de agora as entregas são assinadas com o novo segredo, que vem na resposta; o antigo deixa de valer na hora. - [Enviar teste do webhook](https://docs.postclean.com.br/api-reference/webhooks/send-webhook-test.md): Envia agora um evento de teste assinado para o endpoint e espera até 5 segundos pela resposta: `{id, type: "webhook.test", data: {}, created_at}`. O teste não é registrado e não altera a contagem de falhas. Se o endpoint não for permitido, estiver inacessível ou responder com status diferente de 2xx… - [Listar formatos de origem do repurpose](https://docs.postclean.com.br/api-reference/repurposes/list-repurpose-source-formats.md): Lista os valores aceitos em `source_format`. Sem paginação. O `label` segue o idioma do servidor, português no PostClean. - [Listar repurposes](https://docs.postclean.com.br/api-reference/repurposes/list-repurposes.md): Lista os repurposes do workspace, dos mais novos para os mais antigos, com a conta de origem e a contagem de vídeos republicados. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Criar repurpose](https://docs.postclean.com.br/api-reference/repurposes/create-repurpose.md): Cria um repurpose como rascunho: ele não faz nada até ser ativado. Uma conta de origem que já alimenta um repurpose do mesmo formato retorna `422` em `source_social_account_id`; um destino igual à origem retorna `422` no `social_account_id` desse destino. A legenda de cada vídeo novo é ajustada a ca… - [Ver repurpose](https://docs.postclean.com.br/api-reference/repurposes/get-repurpose.md): Retorna um repurpose. - [Atualizar repurpose](https://docs.postclean.com.br/api-reference/repurposes/update-repurpose.md): Altera só os campos enviados. Num repurpose já ativado, mudar a conta de origem ou o formato reinicia a contagem a partir de agora: só os vídeos postados depois da mudança são republicados. Um repurpose ativo precisa manter uma origem conectada e pelo menos um destino do workspace, e os destinos pre… - [Excluir repurpose](https://docs.postclean.com.br/api-reference/repurposes/delete-repurpose.md): Exclui um repurpose e o histórico de itens dele. Os posts que ele já criou continuam existindo. - [Ativar repurpose](https://docs.postclean.com.br/api-reference/repurposes/activate-repurpose.md): Liga um repurpose em rascunho ou desativado. Só os vídeos postados a partir de agora são republicados. É preciso ter uma conta de origem conectada (`422` em `source_social_account_id`) e pelo menos um destino que ainda esteja no workspace (`422` em `destinations`); os destinos cuja conta foi removid… - [Desativar repurpose](https://docs.postclean.com.br/api-reference/repurposes/disable-repurpose.md): Desliga um repurpose ativo ou pausado. Ao ativar de novo, ele começa daquele momento, então os vídeos postados enquanto estava desligado não são republicados. Em qualquer outro status, a requisição retorna `422` em `status`. - [Listar itens do repurpose](https://docs.postclean.com.br/api-reference/repurposes/list-repurpose-items.md): Lista os vídeos de origem que o repurpose capturou, dos mais novos para os mais antigos (pela data em que foram postados na origem), com os posts criados para cada um. O tamanho da página é definido pelo servidor: leia `meta.per_page`. - [Pausar repurpose](https://docs.postclean.com.br/api-reference/repurposes/pause-repurpose.md): Pausa um repurpose ativo. Ao retomar, os vídeos postados durante a pausa também são republicados. Em qualquer outro status, a requisição retorna `422` em `status`. - [Retomar repurpose](https://docs.postclean.com.br/api-reference/repurposes/resume-repurpose.md): Retoma um repurpose pausado, com as mesmas verificações da ativação. Se a pausa foi sua, ele continua de onde parou, incluindo os vídeos postados durante a pausa. Se a pausa foi do PostClean (`paused_reason` preenchido, por exemplo porque a conta de origem foi desconectada), ele recomeça a partir de… - [Listar tipos de conteúdo](https://docs.postclean.com.br/api-reference/platform/list-content-types.md): Lista cada rede com o limite de texto, o limite de hashtags, o limite do texto alternativo, as configurações obrigatórias (`required_meta`), o tipo de conteúdo padrão e as regras de mídia de cada tipo de conteúdo: quantidade e tamanho das mídias, formatos, proporções, se o texto é enviado (`captionl… - [Introdução](https://docs.postclean.com.br/ai/introduction.md): Conecte assistentes de IA à sua conta do PostClean pelo Model Context Protocol - [Referência de ferramentas](https://docs.postclean.com.br/ai/tools-reference.md): Todas as ferramentas do servidor MCP do PostClean, com os argumentos, quem pode chamar cada uma e o equivalente na API REST - [Claude](https://docs.postclean.com.br/ai/claude.md): Conecte o PostClean ao Claude na web para cuidar das suas redes sociais com IA - [Claude Code](https://docs.postclean.com.br/ai/claude-code.md): Conecte o PostClean ao Claude Code para cuidar das suas redes sociais com IA pelo terminal - [Claude Desktop](https://docs.postclean.com.br/ai/claude-desktop.md): Conecte o PostClean ao app Claude Desktop para cuidar das suas redes sociais com IA - [ChatGPT](https://docs.postclean.com.br/ai/chatgpt.md): Conecte o PostClean ao ChatGPT para cuidar das suas redes sociais com IA - [Muse](https://docs.postclean.com.br/ai/muse.md): Conecte o PostClean ao Muse AI Agent, o agente pessoal da Meta, e ao Muse Code no terminal - [Muse Code](https://docs.postclean.com.br/ai/muse-code.md): Conecte o PostClean ao Muse Code para gerenciar suas redes sociais com IA pelo terminal - [Perplexity](https://docs.postclean.com.br/ai/perplexity.md): Conecte o PostClean ao Perplexity para gerenciar suas redes sociais com IA - [Grok](https://docs.postclean.com.br/ai/grok.md): Conecte o PostClean ao Grok como um conector MCP personalizado - [Cursor](https://docs.postclean.com.br/ai/cursor.md): Conecte o PostClean ao Cursor para gerenciar suas redes sociais com IA dentro do editor - [Devin](https://docs.postclean.com.br/ai/devin.md): Conecte o PostClean ao Devin como um servidor MCP personalizado - [VS Code](https://docs.postclean.com.br/ai/vs-code.md): Conecte o PostClean ao suporte nativo a MCP do VS Code no Copilot Chat - [GitHub Copilot](https://docs.postclean.com.br/ai/github-copilot.md): Conecte o PostClean ao GitHub Copilot no VS Code para gerenciar suas redes sociais com IA - [Gemini CLI](https://docs.postclean.com.br/ai/gemini-cli.md): Conecte o PostClean ao Gemini CLI para gerenciar suas redes sociais com IA pelo terminal - [OpenCode](https://docs.postclean.com.br/ai/opencode.md): Conecte o PostClean ao OpenCode para gerenciar suas redes sociais com IA pelo terminal - [OpenClaw](https://docs.postclean.com.br/ai/openclaw.md): Conecte o PostClean ao OpenClaw para gerenciar suas redes sociais com IA - [Hermes](https://docs.postclean.com.br/ai/hermes.md): Conecte o PostClean ao Hermes Agent como um servidor MCP remoto - [Codex](https://docs.postclean.com.br/ai/codex.md): Conecte o PostClean ao Codex CLI da OpenAI para gerenciar suas redes sociais com IA - [Antigravity](https://docs.postclean.com.br/ai/antigravity.md): Conecte o PostClean ao Google Antigravity para gerenciar suas redes sociais com IA - [Introdução](https://docs.postclean.com.br/knowledge-base/introduction.md): Como o PostClean é organizado: Criar, Publicar, Insights, Repost, Automações, Canais e Configurações. - [Ideias](https://docs.postclean.com.br/knowledge-base/create/ideas.md): Reúna, organize e desenvolva ideias de posts num quadro antes que elas virem posts. - [Modelos](https://docs.postclean.com.br/knowledge-base/create/templates.md): Textos de post reutilizáveis: a biblioteca do PostClean e os modelos da sua equipe e os seus. - [Feeds](https://docs.postclean.com.br/knowledge-base/create/feeds.md): Acompanhe feeds RSS, Atom e JSON e transforme artigos em posts ou ideias. - [Publicar](https://docs.postclean.com.br/knowledge-base/publish/overview.md): Veja e gerencie todos os posts: a fila, as aprovações, os rascunhos e o que foi enviado, em lista ou calendário. - [Editor de posts](https://docs.postclean.com.br/knowledge-base/publish/composer.md): Escreva um post uma vez, personalize para cada rede e escolha quando ele será publicado. - [Mídia](https://docs.postclean.com.br/knowledge-base/media.md): Adicione, edite e descreva imagens, vídeos e PDFs no editor de posts, e veja o que cada rede aceita. - [Fila](https://docs.postclean.com.br/knowledge-base/publish/queue.md): Defina horários de postagem para cada canal e deixe a fila preenchê-los com posts. - [Aprovações](https://docs.postclean.com.br/knowledge-base/publish/approvals.md): Revise e aprove os posts dos membros que precisam de aprovação. - [Posts recorrentes](https://docs.postclean.com.br/knowledge-base/publish/recurring-posts.md): Publique o mesmo post de novo num ritmo que se repete. - [Automações do Instagram](https://docs.postclean.com.br/knowledge-base/automations/overview.md): Responda comentários e mensagens do direct no Instagram automaticamente, com palavras-chave, botões e fluxos de conversa. - [Gatilhos](https://docs.postclean.com.br/knowledge-base/automations/triggers.md): O que dispara uma automação: comentários, mensagens no direct, stories, lives, anúncios e links ig.me com QR code. - [Formulário e editor de blocos](https://docs.postclean.com.br/knowledge-base/automations/flow-editor.md): Monte a conversa no direct pelo formulário de passos ou pelo editor de blocos, com botões, perguntas, condições, etiquetas, variáveis e modelos prontos. - [Verificar se segue](https://docs.postclean.com.br/knowledge-base/automations/follow-gate.md): Entregue o conteúdo só para quem segue o seu perfil, com o botão Já segui para checar de novo. - [Lembrete para quem não clicou](https://docs.postclean.com.br/knowledge-base/automations/reminders.md): Mande um lembrete no direct para quem recebeu o link e não abriu, usando os links rastreados da entrega. - [Proteção contra spam](https://docs.postclean.com.br/knowledge-base/automations/spam-protection.md): Como o PostClean limita as respostas públicas em posts movimentados para o Instagram não restringir a sua conta. - [Limites da Meta](https://docs.postclean.com.br/knowledge-base/automations/meta-limits.md): As regras do Instagram para mensagens automáticas e o que o PostClean faz quando um limite é atingido. - [Contatos e etiquetas](https://docs.postclean.com.br/knowledge-base/automations/contacts.md): Veja quem conversou com as suas automações, organize com etiquetas e exporte para Excel ou Google Planilhas. - [Integrações](https://docs.postclean.com.br/knowledge-base/automations/integrations.md): Mande os contatos das automações para o CRM da ChatClean, para qualquer CRM por webhook ou para uma planilha do Google. - [Agente externo do direct](https://docs.postclean.com.br/knowledge-base/automations/external-agent.md): Conecte um agente de IA, como um fluxo do n8n, para responder o direct de um canal do Instagram. - [Insights](https://docs.postclean.com.br/knowledge-base/insights/overview.md): Veja o desempenho dos seus canais e posts em todo o workspace. - [Insights do canal](https://docs.postclean.com.br/knowledge-base/insights/channel-insights.md): Acompanhe os seguidores e o alcance de um canal e o desempenho de cada post. - [Tráfego pago](https://docs.postclean.com.br/knowledge-base/insights/paid-traffic.md): Veja investimento, alcance, cliques e resultados dos seus anúncios da Meta ao lado dos posts orgânicos. - [Repost](https://docs.postclean.com.br/knowledge-base/repurpose.md): Acompanhe uma conta do Instagram ou do Facebook e republique cada vídeo novo nas suas outras redes. - [Conectar um canal](https://docs.postclean.com.br/knowledge-base/channels/connecting.md): Conecte suas contas sociais a um workspace, escolha em quais o PostClean publica e reconecte um canal que perdeu a conexão. - [Configurações do canal](https://docs.postclean.com.br/knowledge-base/channels/settings.md): Ordene seus canais e defina o fuso horário, a meta de postagem e os horários de postagem de cada um. - [Desconectar um canal](https://docs.postclean.com.br/knowledge-base/channels/disconnecting.md): Remova um canal de um workspace. Desconectar apaga todos os posts desse canal no PostClean. - [Perfil](https://docs.postclean.com.br/knowledge-base/settings/profile.md): Mude seu nome, seu endereço de e-mail e sua foto de perfil. - [Preferências](https://docs.postclean.com.br/knowledge-base/settings/preferences.md): Escolha o tema, o idioma da interface, o fuso horário, o formato de hora, o início da semana e a ação padrão de publicação. - [Autenticação](https://docs.postclean.com.br/knowledge-base/settings/authentication.md): Gerencie sua senha, o login com Google, as sessões ativas e a exclusão da sua conta. - [Notificações](https://docs.postclean.com.br/knowledge-base/settings/notifications.md): Escolha quais e-mails o PostClean manda para você. - [Workspaces](https://docs.postclean.com.br/knowledge-base/settings/workspaces.md): Crie, troque, renomeie e exclua workspaces: um para cada marca ou cliente. - [Membros e permissões](https://docs.postclean.com.br/knowledge-base/settings/members-and-permissions.md): Convide pessoas da equipe para um workspace, torne-as administradoras e decida quais posts precisam de aprovação. - [Assinaturas](https://docs.postclean.com.br/knowledge-base/settings/signatures.md): Salve textos que você usa sempre nos posts (hashtags, links, uma despedida) e adicione pelo editor. - [Etiquetas](https://docs.postclean.com.br/knowledge-base/settings/labels.md): Organize e filtre seus posts e ideias com etiquetas coloridas. - [Webhooks](https://docs.postclean.com.br/knowledge-base/settings/webhooks.md): Receba notificações HTTP assinadas quando posts são criados, agendados, publicados, falham ou são excluídos. - [Chaves de API](https://docs.postclean.com.br/knowledge-base/settings/api-keys.md): Crie, gere novamente e exclua as chaves que autenticam as requisições à API REST do PostClean. - [MCP](https://docs.postclean.com.br/knowledge-base/settings/mcp.md): Conecte o Claude, o ChatGPT, o Cursor e outros assistentes de IA ao seu workspace, e desconecte quando quiser. - [Planos e cobrança](https://docs.postclean.com.br/knowledge-base/settings/plans-and-billing.md): Como funcionam os planos do PostClean, como a assinatura começa e como mudar de plano, atualizar o cartão ou cancelar. ## OpenAPI Specs - [openapi](/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.