REST APIPATCH

Actualizar publicación

Actualiza una publicación programada enviando solo los campos que quieres cambiar; la API devuelve el objeto completo.

PATCHhttps://post.adaptlypost.com/post/api/v1/social-posts/:id

Actualizar una publicacion existente. Todos los campos son opcionales: envie solo los campos que desea cambiar.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

Editar un borrador necesita posts.draft. Editar una publicación programada necesita posts.schedule. Una publicación creada por otro miembro necesita además posts.others, que los Colaboradores no tienen.

Parametros del cuerpo

Parametro	Tipo	Descripcion
`platforms`	`PlatformType[]`	Plataformas objetivo
`contentType`	`ContentType`	TEXT, IMAGE, VIDEO, CAROUSEL o DOCUMENT. DOCUMENT es solo para LinkedIn: exactamente un archivo PDF, PPT, PPTX, DOC o DOCX en mediaUrls, mostrado como documento deslizable
`text`	`string`	Contenido de texto de la publicacion
`platformTexts`	`PlatformText[]`	Sobrescrituras de texto por plataforma
`mediaUrls`	`string[]`	URLs de archivos multimedia cargados
`mediaAltTexts`	`string[]`	Texto alternativo de cada imagen, en el mismo orden que mediaUrls. Máximo 1000 caracteres cada uno; usa una cadena vacía para omitir una imagen. Se envía a X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram y Threads. Pinterest usa el primero, recortado a 500 caracteres. TikTok, YouTube y los vídeos lo ignoran.
`thumbnailUrl`	`string`	URL de miniatura para publicaciones de video
`thumbnailTimestampMs`	`number`	Fotograma del video que se usa como miniatura, en milisegundos desde el inicio
`platformThumbnails`	`PlatformThumbnail[]`	Una miniatura distinta por plataforma, como al crear. Enviar la lista reemplaza todas las miniaturas propias; omitirla mantiene las guardadas
`firstComments`	`PlatformFirstComment[]`	Primeros comentarios por plataforma, igual que al crear. Enviar la lista reemplaza todos los comentarios guardados y una lista vacía los borra; si se omite, se mantienen los guardados
`scheduledAt`	`string`	Fecha de reprogramacion (ISO 8601)
`timezone`	`string`	Zona horaria IANA
`pageIds`	`string[]`	Páginas de Facebook en las que publicar. Se acepta el id de la cuenta o el pageId de /social-accounts
`twitterConnectionIds`	`string[]`	IDs de conexión de la cuenta de Twitter
`twitterKeepLinks`	`boolean`	Mantiene clicables los enlaces del texto de X, igual que al crear. Si no se envía, se conserva el valor guardado
`linkedinConnectionIds`	`string[]`	IDs de conexión de la cuenta de LinkedIn
`instagramConnectionIds`	`string[]`	IDs de conexión de la cuenta de Instagram
`tiktokConnectionIds`	`string[]`	IDs de conexión de la cuenta de TikTok
`youtubeConnectionIds`	`string[]`	IDs de conexión del canal de YouTube
`pinterestConnectionIds`	`string[]`	IDs de conexión de la cuenta de Pinterest
`blueskyConnectionIds`	`string[]`	IDs de conexión de la cuenta de Bluesky
`mastodonConnectionIds`	`string[]`	IDs de conexión de la cuenta de Mastodon
`threadsConnectionIds`	`string[]`	IDs de conexión de la cuenta de Threads
`pinterestConfigs`	`PinterestConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma
`tiktokConfigs`	`TikTokConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma
`instagramConfigs`	`InstagramConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma
`facebookConfigs`	`FacebookConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma
`youtubeConfigs`	`YouTubeConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma
`linkedinConfigs`	`LinkedInConfig[]`	Configuración de esta plataforma, un objeto por cuenta, cada uno con el connectionId al que se aplica (pageId en Facebook). Consulte Configuraciones de plataforma

Todos los campos son opcionales. Incluye solo los campos que quieres actualizar. La respuesta devuelve el objeto completo de la publicación actualizada.

Reprogramar en el pasado

Mover el scheduledAt de una publicacion programada mas de un minuto al pasado devuelve 400 "The new scheduled time is in the past. Choose a time in the future". Para publicarla de inmediato, usa Publicar borrador.

Una cuenta por plataforma

Solo se permite una cuenta por plataforma por publicacion. No puede actualizar una publicacion para incluir multiples cuentas en la misma plataforma. Esta restriccion se aplica para cumplir con los Terminos de Servicio de las plataformas.

Actualizar una publicacion 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"
}

Actualizar publicación

Parametros del cuerpo

AdaptlyPost

Contacto