REST APIPATCH
Atualizar Publicação
Atualize uma publicação agendada enviando apenas os campos que deseja alterar; a API retorna o objeto completo.
PATCH
https://post.adaptlypost.com/post/api/v1/social-posts/:idAtualizar uma publicação existente. Todos os campos são opcionais, envie apenas os campos que deseja alterar.
Chave API (Bearer token)
Editar um rascunho exige posts.draft. Editar uma publicação agendada exige posts.schedule. Uma publicação criada por outro membro exige também posts.others, que Colaboradores não têm.
Parâmetros do Corpo
| Parâmetro | Tipo | Descrição |
|---|---|---|
platforms | PlatformType[] | Plataformas alvo |
contentType | ContentType | TEXT, IMAGE, VIDEO, CAROUSEL ou DOCUMENT. DOCUMENT é só para o LinkedIn: exatamente um arquivo PDF, PPT, PPTX, DOC ou DOCX em mediaUrls, exibido como documento deslizável |
text | string | Conteúdo de texto da publicação. No LinkedIn, mencione uma página de empresa com @[Nome da página](urn:li:organization:<id>), escrevendo o nome exatamente como o LinkedIn o mostra. O LinkedIn só permite mencionar páginas de empresa, não pessoas |
platformTexts | PlatformText[] | Substituições de texto por plataforma |
mediaUrls | string[] | URLs de arquivos de mídia enviados |
mediaAltTexts | string[] | Texto alternativo de cada imagem, na mesma ordem que mediaUrls. Máximo de 1000 caracteres cada; use uma string vazia para ignorar uma imagem. Enviado para X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram e Threads. O Pinterest usa o primeiro, cortado a 500 caracteres. TikTok, YouTube, o Perfil da Empresa no Google e vídeos o ignoram. |
thumbnailUrl | string | URL da miniatura para publicações em vídeo |
thumbnailTimestampMs | number | Quadro do vídeo a usar como miniatura, em milissegundos desde o início |
platformThumbnails | PlatformThumbnail[] | Uma miniatura diferente por plataforma, como na criação. Enviar a lista substitui todas as miniaturas próprias; omiti-la mantém as salvas |
platformAspectRatios | PlatformAspectRatio[] | Formato de imagem por plataforma, como na criação. Vale para as mediaUrls enviadas na mesma requisição |
firstComments | PlatformFirstComment[] | Primeiros comentários por plataforma, como na criação. Enviar a lista substitui todos os comentários salvos e uma lista vazia os apaga; sem o campo, os salvos são mantidos |
threadReplies | PlatformThreadReplies[] | Fios por plataforma, como ao criar. Enviar a lista substitui todos os fios guardados e uma lista vazia apaga-os; sem a lista, os guardados mantêm-se |
scheduledAt | string | Data de reagendamento (ISO 8601) |
timezone | string | Fuso horário IANA |
pageIds | string[] | Páginas do Facebook onde publicar. Aceita o id da conta ou o pageId de /social-accounts |
twitterConnectionIds | string[] | IDs de conexão da conta do Twitter |
twitterKeepLinks | boolean | Mantém clicáveis os links do texto do X, como na criação. Se o campo for omitido, o valor salvo é mantido |
linkedinConnectionIds | string[] | IDs de conexão da conta do LinkedIn |
instagramConnectionIds | string[] | IDs de conexão da conta do Instagram |
tiktokConnectionIds | string[] | IDs de conexão da conta do TikTok |
youtubeConnectionIds | string[] | IDs de conexão do canal do YouTube |
pinterestConnectionIds | string[] | IDs de conexão da conta do Pinterest |
blueskyConnectionIds | string[] | IDs de conexão da conta do Bluesky |
mastodonConnectionIds | string[] | IDs de conexão da conta do Mastodon |
googleBusinessConnectionIds | string[] | IDs de conexão dos locais do Perfil da Empresa no Google |
googleBusinessConfigs | GoogleBusinessConfig[] | Configurações de post do Perfil da Empresa no Google por local: tipo de post (novidade, evento ou oferta), botão, datas do evento e detalhes da oferta. Consulte Configurações de Plataforma para o esquema |
tumblrConnectionIds | string[] | IDs de conexão dos blogs do Tumblr |
telegramConnectionIds | string[] | IDs de conexão dos canais e grupos do Telegram |
tumblrConfigs | TumblrConfig[] | Configurações do Tumblr por blog: tags, título e link de origem. Veja Configurações de plataforma para o esquema |
threadsConnectionIds | string[] | IDs de conexão da conta do Threads |
pinterestConfigs | PinterestConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
tiktokConfigs | TikTokConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
instagramConfigs | InstagramConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
facebookConfigs | FacebookConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
youtubeConfigs | YouTubeConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
linkedinConfigs | LinkedInConfig[] | Configurações desta plataforma, um objeto por conta, cada um com o connectionId a que se aplica (pageId no Facebook). Consulte Configurações de Plataforma |
Todos os campos são opcionais. Inclua apenas os campos que deseja atualizar. A resposta retorna o objeto completo da publicação atualizada.
Reagendar para o passado
Mover o scheduledAt de uma publicação agendada mais de um minuto para o passado devolve 400 "The new scheduled time is in the past. Choose a time in the future". Para publicar imediatamente, use Publicar Rascunho.Uma conta por plataforma
Apenas uma conta por plataforma é permitida por publicação. Você não pode atualizar uma publicação para incluir múltiplas contas na mesma plataforma. Esta restrição é aplicada para cumprir os Termos de Serviço das plataformas.Atualizar uma publicação social
curl --request PATCH \
--url https://post.adaptlypost.com/post/api/v1/social-posts/post_xyz789 \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"text": "Updated post content!",
"platforms": ["TWITTER", "LINKEDIN"],
"scheduledAt": "2026-03-15T10:00:00Z",
"timezone": "America/New_York",
"twitterConnectionIds": ["conn_abc123"],
"linkedinConnectionIds": ["conn_def456"]
}'200
{
"id": "post_xyz789",
"contentType": "TEXT",
"text": "Updated post content!",
"status": "SCHEDULED",
"scheduledAt": "2026-03-15T10:00:00Z",
"timezone": "America/New_York",
"platforms": [
{
"id": "pp_001",
"platform": "TWITTER",
"status": "PENDING",
"accountName": "@yourhandle"
},
{
"id": "pp_002",
"platform": "LINKEDIN",
"status": "PENDING",
"accountName": "Your Company"
}
],
"createdAt": "2026-03-14T11:59:00Z",
"updatedAt": "2026-03-15T08:30:00Z"
}