REST APIPATCH

Zaktualizuj post

Zaktualizuj zaplanowany post, wysyłając tylko pola, które chcesz zmienić; API zwraca pełny obiekt zaktualizowanego posta.

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

Aktualizuje istniejący post. Wszystkie pola są opcjonalne, wystarczy wysłać te do zmiany. Zwraca cały zaktualizowany post.

Klucz API (token Bearer)
Uprawnienie:posts.draftRole i uprawnienia

Edycja wersji roboczej wymaga posts.draft. Edycja zaplanowanego posta wymaga posts.schedule. Post utworzony przez innego członka wymaga też posts.others, którego Współtwórcy nie mają.

Parametry treści żądania

ParametrTypOpis
platformsPlatformType[]Docelowe platformy
contentTypeContentTypeTEXT, IMAGE, VIDEO, CAROUSEL lub DOCUMENT. DOCUMENT działa tylko na LinkedIn: dokładnie jeden plik PDF, PPT, PPTX, DOC lub DOCX w mediaUrls, wyświetlany jako dokument do przewijania
textstringTreść posta. Na LinkedIn stronę firmową można oznaczyć za pomocą @[Page Name](urn:li:organization:<id>), podając nazwę strony dokładnie tak, jak wyświetla ją LinkedIn. LinkedIn pozwala oznaczać tylko strony firmowe, nie osoby. GET /api/v1/linkedin-organizations/lookup (zob. Konta społecznościowe) zwraca taką wzmiankę dla adresu URL strony lub jej nazwy własnej
platformTextsPlatformText[]Osobne teksty dla poszczególnych platform
mediaUrlsstring[]Adresy URL przesłanych plików multimedialnych
mediaAltTextsstring[]Tekst alternatywny każdego obrazu, w tej samej kolejności co mediaUrls. Maks. 1000 znaków każdy; pusty ciąg pomija obraz. Wysyłany do X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram i Threads. Pinterest używa pierwszego, skróconego do 500 znaków. TikTok, YouTube, Google Business Profile i filmy go ignorują.
thumbnailUrlstringMiniatura posta wideo jako adres URL https lub data URI obrazu. Używa jej każda platforma obsługująca miniatury, chyba że platformThumbnails ją nadpisuje
thumbnailTimestampMsnumberKlatka filmu użyta jako miniatura, w milisekundach od początku. Działa na YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM i TIKTOK. Wysłany razem z nią thumbnailUrl ma pierwszeństwo wszędzie poza TIKTOK, który przyjmuje tylko klatkę. platformThumbnails nadpisuje oba
platformThumbnailsPlatformThumbnail[]Osobna miniatura dla platformy, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie nadpisania; pominięcie zachowuje zapisane
platformMediaPlatformMedia[]Osobne multimedia dla platformy, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie nadpisania, [] je usuwa, a pominięcie zachowuje zapisane. Działa także bez wysłania platforms
platformAspectRatiosPlatformAspectRatio[]Kształt obrazów dla platformy, jak przy tworzeniu. Dotyczy mediaUrls wysłanych w tym samym żądaniu
firstCommentsPlatformFirstComment[]Pierwsze komentarze dla platform, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie zapisane komentarze, pusta lista je usuwa, a pominięcie zachowuje
threadRepliesPlatformThreadReplies[]Wątki dla platform, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie zapisane wątki, pusta lista je usuwa, a pominięcie zachowuje
scheduledAtstringNowy termin (ISO 8601). null usuwa planowaną datę z wersji roboczej lub posta, który zawiódł na wszystkich platformach, i zdejmuje go z kalendarza; dla zaplanowanego posta null zwraca 400, należy wtedy użyć Cofnij zaplanowanie. Pominięcie pola zachowuje obecną datę
timezonestringStrefa czasowa IANA
pageIdsstring[]Strony na Facebooku, na których ma się pojawić post. Przyjmuje id konta lub pageId z /social-accounts
twitterConnectionIdsstring[]Identyfikatory połączeń kont Twitter
twitterKeepLinksbooleanZachowuje klikalne linki w tekście na X, jak przy tworzeniu. Pominięcie zachowuje zapisaną wartość
linkedinConnectionIdsstring[]Identyfikatory połączeń kont LinkedIn
instagramConnectionIdsstring[]Identyfikatory połączeń kont Instagram
tiktokConnectionIdsstring[]Identyfikatory połączeń kont TikTok
youtubeConnectionIdsstring[]Identyfikatory połączeń kanałów YouTube
pinterestConnectionIdsstring[]Identyfikatory połączeń kont Pinterest
blueskyConnectionIdsstring[]Identyfikatory połączeń kont Bluesky
mastodonConnectionIdsstring[]Identyfikatory połączeń kont Mastodon
googleBusinessConnectionIdsstring[]Identyfikatory połączeń lokalizacji Google Business Profile
googleBusinessConfigsGoogleBusinessConfig[]Ustawienia posta Google Business Profile dla każdej lokalizacji: typ posta (aktualność, wydarzenie lub oferta), przycisk, daty wydarzenia i szczegóły oferty. Schemat opisano w sekcji Konfiguracje platform
tumblrConnectionIdsstring[]Identyfikatory połączeń blogów Tumblr
wordpressConnectionIdsstring[]Identyfikatory połączeń witryn WordPress
telegramConnectionIdsstring[]Identyfikatory połączeń kanałów i grup Telegram
tumblrConfigsTumblrConfig[]Ustawienia posta Tumblr dla każdego bloga: tagi, tytuł i link do źródła. Schemat opisano w sekcji Konfiguracje platform
wordpressConfigsWordPressConfig[]Ustawienia posta WordPress dla każdej witryny: tytuł, zajawka, kategorie, tagi i status. Schemat opisano w sekcji Konfiguracje platform
threadsConnectionIdsstring[]Identyfikatory połączeń kont Threads
pinterestConfigsPinterestConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
tiktokConfigsTikTokConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
instagramConfigsInstagramConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
facebookConfigsFacebookConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
youtubeConfigsYouTubeConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
linkedinConfigsLinkedInConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
twitterConfigsTwitterConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
Wszystkie pola są opcjonalne. Wystarczy podać pola do zmiany. Odpowiedź zawiera cały zaktualizowany obiekt posta.

Edycja nieudanego posta

Post, który zawiódł na wszystkich platformach, po aktualizacji znowu staje się wersją roboczą, a jego platformy wracają do stanu oczekiwania. Można go opublikować lub zaplanować przez Opublikuj wersję roboczą. Posta opublikowanego na części platform, a nieudanego na pozostałych, nie można edytować: należy ponowić nieudane platformy.

Przenoszenie terminu w przeszłość

Przesunięcie scheduledAt zaplanowanego posta o ponad minutę w przeszłość zwraca 400 „The new scheduled time is in the past. Choose a time in the future”. Aby opublikować post od razu, należy użyć Opublikuj wersję roboczą.

Jedno konto na platformę

W jednym poście dozwolone jest tylko jedno konto na platformę. Posta nie można zaktualizować tak, aby zawierał kilka kont na tej samej platformie. Ograniczenie wynika z regulaminów platform.
Aktualizacja posta
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"
}