REST APIPATCH

Beitrag aktualisieren

Aktualisieren Sie einen geplanten Beitrag, indem Sie nur die zu ändernden Felder senden. Die API gibt das ganze Objekt zurück.

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

Einen bestehenden Beitrag aktualisieren. Alle Felder sind optional, senden Sie nur die Felder, die Sie ändern möchten.

API-Schlüssel (Bearer-Token)
Berechtigung:posts.draftRollen und Berechtigungen

Einen Entwurf bearbeiten braucht posts.draft. Einen geplanten Beitrag bearbeiten braucht posts.schedule. Ein von einem anderen Mitglied erstellter Beitrag braucht zusätzlich posts.others, das Mitwirkende nicht haben.

Body-Parameter

ParameterTypBeschreibung
platformsPlatformType[]Zielplattformen
contentTypeContentTypeTEXT, IMAGE, VIDEO, CAROUSEL oder DOCUMENT. DOCUMENT gibt es nur für LinkedIn: genau eine PDF-, PPT-, PPTX-, DOC- oder DOCX-Datei in mediaUrls, angezeigt als durchblätterbares Dokument
textstringTextinhalt des Beitrags
platformTextsPlatformText[]Textspezifische Überschreibungen pro Plattform
mediaUrlsstring[]URLs hochgeladener Mediendateien
mediaAltTextsstring[]Alternativtext für jedes Bild, in derselben Reihenfolge wie mediaUrls. Höchstens 1000 Zeichen pro Eintrag; ein leerer String überspringt ein Bild. Wird an X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram und Threads gesendet. Pinterest verwendet den ersten, gekürzt auf 500 Zeichen. TikTok, YouTube, das Google Unternehmensprofil und Videos ignorieren ihn.
thumbnailUrlstringThumbnail-URL für Videobeiträge
thumbnailTimestampMsnumberVideobild, das als Vorschaubild dient, in Millisekunden ab Beginn
platformThumbnailsPlatformThumbnail[]Ein anderes Thumbnail pro Plattform, wie beim Erstellen. Die gesendete Liste ersetzt alle Einträge; ohne sie bleiben die gespeicherten erhalten
firstCommentsPlatformFirstComment[]Erste Kommentare pro Plattform, wie beim Erstellen. Die gesendete Liste ersetzt alle gespeicherten Kommentare, eine leere Liste löscht sie; ohne das Feld bleiben die gespeicherten erhalten
scheduledAtstringNeues Planungsdatum (ISO 8601)
timezonestringIANA-Zeitzone
pageIdsstring[]Facebook-Seiten, auf denen gepostet wird. Akzeptiert entweder die Konto-id oder die pageId aus /social-accounts
twitterConnectionIdsstring[]Twitter-Konto-Verbindungs-IDs
twitterKeepLinksbooleanLinks im X-Text klickbar lassen, wie beim Erstellen. Wird das Feld weggelassen, bleibt der gespeicherte Wert erhalten
linkedinConnectionIdsstring[]LinkedIn-Konto-Verbindungs-IDs
instagramConnectionIdsstring[]Instagram-Konto-Verbindungs-IDs
tiktokConnectionIdsstring[]TikTok-Konto-Verbindungs-IDs
youtubeConnectionIdsstring[]YouTube-Kanal-Verbindungs-IDs
pinterestConnectionIdsstring[]Pinterest-Konto-Verbindungs-IDs
blueskyConnectionIdsstring[]Bluesky-Konto-Verbindungs-IDs
mastodonConnectionIdsstring[]Mastodon-Konto-Verbindungs-IDs
googleBusinessConnectionIdsstring[]Verbindungs-IDs der Standorte im Google Unternehmensprofil
googleBusinessConfigsGoogleBusinessConfig[]Beitragseinstellungen für das Google Unternehmensprofil pro Standort: Beitragstyp (Neuigkeit, Veranstaltung oder Angebot), Schaltfläche, Veranstaltungsdaten und Angebotsdetails. Siehe Plattform-Konfigurationen für das Schema
threadsConnectionIdsstring[]Threads-Konto-Verbindungs-IDs
pinterestConfigsPinterestConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
tiktokConfigsTikTokConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
instagramConfigsInstagramConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
facebookConfigsFacebookConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
youtubeConfigsYouTubeConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
linkedinConfigsLinkedInConfig[]Einstellungen für diese Plattform, ein Objekt pro Konto, jeweils mit der connectionId, für die es gilt (pageId bei Facebook). Siehe Plattform-Konfigurationen
Alle Felder sind optional. Gib nur die Felder an, die du aktualisieren möchtest. Die Antwort gibt das vollständige aktualisierte Beitragsobjekt zurück.

Planung in die Vergangenheit

Wird scheduledAt eines geplanten Beitrags mehr als eine Minute in die Vergangenheit verschoben, antwortet die API mit 400 "The new scheduled time is in the past. Choose a time in the future". Um ihn sofort zu veröffentlichen, nutzen Sie Entwurf veröffentlichen.

Ein Konto pro Plattform

Pro Beitrag ist nur ein Konto pro Plattform erlaubt. Sie können einen Beitrag nicht so aktualisieren, dass mehrere Konten derselben Plattform enthalten sind. Diese Einschränkung gilt zur Einhaltung der Nutzungsbedingungen der Plattformen.
Einen Social-Media-Beitrag aktualisieren
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"
}