REST APIPATCH

Mettre à jour un post

Mettez à jour une publication planifiée en n'envoyant que les champs à modifier ; l'API renvoie l'objet complet mis à jour.

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

Modifier une publication existante. Tous les champs sont optionnels, envoyez uniquement les champs que vous souhaitez modifier.

Clé API (jeton Bearer)

Permission:posts.draftRôles et permissions

Modifier un brouillon exige posts.draft. Modifier une publication planifiée exige posts.schedule. Une publication créée par un autre membre exige en plus posts.others, que les Contributeurs n'ont pas.

Paramètres du corps

Paramètre	Taper	Description
`platforms`	`PlatformType[]`	Plateformes cibles
`contentType`	`ContentType`	TEXT, IMAGE, VIDEO, CAROUSEL ou DOCUMENT. DOCUMENT est réservé à LinkedIn : exactement un fichier PDF, PPT, PPTX, DOC ou DOCX dans mediaUrls, affiché comme un document à faire défiler
`text`	`string`	Contenu texte de la publication. Sur LinkedIn, mentionnez une page entreprise avec @[Nom de la page](urn:li:organization:<id>), en écrivant le nom exactement comme LinkedIn l'affiche. LinkedIn n'autorise que les mentions de pages entreprise, pas de personnes
`platformTexts`	`PlatformText[]`	Remplacements de texte par plateforme
`mediaUrls`	`string[]`	URLs des fichiers médias téléversés
`mediaAltTexts`	`string[]`	Texte alternatif de chaque image, dans le même ordre que mediaUrls. 1000 caractères maximum par entrée ; une chaîne vide ignore une image. Envoyé à X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram et Threads. Pinterest utilise le premier, tronqué à 500 caractères. TikTok, YouTube, la fiche d'établissement Google et les vidéos l'ignorent.
`thumbnailUrl`	`string`	URL de miniature pour les publications vidéo
`thumbnailTimestampMs`	`number`	Image de la vidéo à utiliser comme miniature, en millisecondes depuis le début
`platformThumbnails`	`PlatformThumbnail[]`	Une miniature différente par plateforme, comme à la création. Envoyer la liste remplace toutes les miniatures propres ; l'omettre garde celles enregistrées
`platformAspectRatios`	`PlatformAspectRatio[]`	Format des images par plateforme, comme à la création. Il s’applique aux mediaUrls envoyées dans la même requête
`firstComments`	`PlatformFirstComment[]`	Premiers commentaires par plateforme, comme à la création. Envoyer la liste remplace tous les commentaires enregistrés et une liste vide les supprime ; sans le champ, les commentaires enregistrés sont conservés
`threadReplies`	`PlatformThreadReplies[]`	Fils par plateforme, comme à la création. Envoyer la liste remplace tous les fils enregistrés et une liste vide les efface ; sans la liste, les fils enregistrés restent
`scheduledAt`	`string`	Date de reprogrammation (ISO 8601)
`timezone`	`string`	Fuseau horaire IANA
`pageIds`	`string[]`	Pages Facebook sur lesquelles publier. Accepte soit l'id du compte, soit le pageId de /social-accounts
`twitterConnectionIds`	`string[]`	IDs de connexion du compte Twitter
`twitterKeepLinks`	`boolean`	Garde les liens du texte X cliquables, comme à la création. Si le champ est omis, la valeur enregistrée est conservée
`linkedinConnectionIds`	`string[]`	IDs de connexion du compte LinkedIn
`instagramConnectionIds`	`string[]`	IDs de connexion du compte Instagram
`tiktokConnectionIds`	`string[]`	IDs de connexion du compte TikTok
`youtubeConnectionIds`	`string[]`	IDs de connexion de la chaîne YouTube
`pinterestConnectionIds`	`string[]`	IDs de connexion du compte Pinterest
`blueskyConnectionIds`	`string[]`	IDs de connexion du compte Bluesky
`mastodonConnectionIds`	`string[]`	IDs de connexion du compte Mastodon
`googleBusinessConnectionIds`	`string[]`	IDs de connexion des établissements de la fiche Google
`googleBusinessConfigs`	`GoogleBusinessConfig[]`	Paramètres de post de la fiche d'établissement Google par établissement : type de post (nouveauté, événement ou offre), bouton, dates de l'événement et détails de l'offre. Consultez Configurations des plateformes pour le schéma
`tumblrConnectionIds`	`string[]`	ID de connexion des blogs Tumblr
`telegramConnectionIds`	`string[]`	ID de connexion des canaux et groupes Telegram
`tumblrConfigs`	`TumblrConfig[]`	Paramètres Tumblr par blog : tags, titre et lien source. Voir Configurations des plateformes pour le schéma
`threadsConnectionIds`	`string[]`	IDs de connexion du compte Threads
`pinterestConfigs`	`PinterestConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes
`tiktokConfigs`	`TikTokConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes
`instagramConfigs`	`InstagramConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes
`facebookConfigs`	`FacebookConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes
`youtubeConfigs`	`YouTubeConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes
`linkedinConfigs`	`LinkedInConfig[]`	Paramètres de cette plateforme, un objet par compte, chacun avec le connectionId auquel il s'applique (pageId pour Facebook). Consultez Configurations des plateformes

Tous les champs sont facultatifs. Incluez uniquement les champs que vous voulez mettre à jour. La réponse renvoie l’objet complet de la publication mise à jour.

Reprogrammer dans le passé

Déplacer le scheduledAt d'une publication programmée de plus d'une minute dans le passé renvoie 400 "The new scheduled time is in the past. Choose a time in the future". Pour la publier tout de suite, utilisez Publier un brouillon.

Un compte par plateforme

Un seul compte par plateforme est autorisé par publication. Vous ne pouvez pas mettre à jour une publication pour inclure plusieurs comptes sur la même plateforme. Cette restriction est appliquée pour respecter les conditions d'utilisation des plateformes.

Modifier une publication sociale

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"
}

Mettre à jour un post

Paramètres du corps

AdaptlyPost

Contact