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 publicación existente. Todos los campos son opcionales: envíe 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.

Parámetros del cuerpo

Parámetro	Tipo	Descripción
`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 publicación. En LinkedIn, menciona una página de empresa con @[Nombre de la página](urn:li:organization:<id>), escribiendo el nombre exactamente como lo muestra LinkedIn. LinkedIn solo permite mencionar páginas de empresa, no personas
`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, el Perfil de Empresa de Google 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
`platformAspectRatios`	`PlatformAspectRatio[]`	Formato de imagen por plataforma, como al crear. Se aplica a las mediaUrls enviadas en la misma solicitud
`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
`threadReplies`	`PlatformThreadReplies[]`	Hilos por plataforma, como al crear. Enviar la lista reemplaza todos los hilos guardados y una lista vacía los borra; si no la envías, se mantienen los guardados
`scheduledAt`	`string`	Fecha de reprogramación (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
`googleBusinessConnectionIds`	`string[]`	IDs de conexión de las ubicaciones del Perfil de Empresa de Google
`googleBusinessConfigs`	`GoogleBusinessConfig[]`	Ajustes de publicación del Perfil de Empresa de Google por ubicación: tipo de publicación (novedad, evento u oferta), botón, fechas del evento y detalles de la oferta. Consulte Configuraciones de plataforma para el esquema
`tumblrConnectionIds`	`string[]`	IDs de conexión de blogs de Tumblr
`telegramConnectionIds`	`string[]`	IDs de conexión de canales y grupos de Telegram
`tumblrConfigs`	`TumblrConfig[]`	Ajustes de Tumblr por blog: etiquetas, título y enlace de origen. Consulta Configuraciones de plataforma para el esquema
`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 publicación programada más 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 publicación. No puede actualizar una publicación para incluir múltiples cuentas en la misma plataforma. Esta restricción se aplica para cumplir con los Términos de Servicio de las plataformas.

Actualizar una publicación 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

Parámetros del cuerpo

AdaptlyPost

Contacto