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 publicacao existente. Todos os campos sao opcionais, envie apenas os campos que pretende 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.
Parametros do Corpo
| Parametro | Tipo | Descricao |
|---|---|---|
platforms | PlatformType[] | Plataformas alvo |
contentType | ContentType | TEXT, IMAGE, VIDEO, CAROUSEL ou DOCUMENT. DOCUMENT é só para o LinkedIn: exatamente um ficheiro PDF, PPT, PPTX, DOC ou DOCX em mediaUrls, apresentado como documento deslizável |
text | string | Conteudo de texto da publicacao |
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 ignoram-no. |
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 |
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 |
scheduledAt | string | Data de reagendamento (ISO 8601) |
timezone | string | Fuso horario 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 Configuracoes 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 Configuracoes 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 Configuracoes 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 Configuracoes 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 Configuracoes 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 Configuracoes 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 Configuracoes 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 publicacao 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 de imediato, use Publicar Rascunho.Uma conta por plataforma
Apenas uma conta por plataforma e permitida por publicacao. Nao pode atualizar uma publicacao para incluir multiplas contas na mesma plataforma. Esta restricao e aplicada para cumprir os Termos de Servico das plataformas.Atualizar uma publicacao 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"
}