REST APIPATCH
Zaktualizuj post
Zaktualizuj zaplanowany post, wysyłając tylko pola, które chcesz zmienić; API zwraca pełny obiekt zaktualizowanego posta.
PATCH
https://post.adaptlypost.com/post/api/v1/social-posts/:idAktualizuje istniejący post. Wszystkie pola są opcjonalne, wystarczy wysłać te do zmiany. Zwraca cały zaktualizowany post.
Klucz API (token Bearer)
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
| Parametr | Typ | Opis |
|---|---|---|
platforms | PlatformType[] | Docelowe platformy |
contentType | ContentType | TEXT, 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 |
text | string | Treść 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 |
platformTexts | PlatformText[] | Osobne teksty dla poszczególnych platform |
mediaUrls | string[] | Adresy URL przesłanych plików multimedialnych |
mediaAltTexts | string[] | 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ą. |
thumbnailUrl | string | Miniatura 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 |
thumbnailTimestampMs | number | Klatka 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 |
platformThumbnails | PlatformThumbnail[] | Osobna miniatura dla platformy, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie nadpisania; pominięcie zachowuje zapisane |
platformMedia | PlatformMedia[] | 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 |
platformAspectRatios | PlatformAspectRatio[] | Kształt obrazów dla platformy, jak przy tworzeniu. Dotyczy mediaUrls wysłanych w tym samym żądaniu |
firstComments | PlatformFirstComment[] | Pierwsze komentarze dla platform, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie zapisane komentarze, pusta lista je usuwa, a pominięcie zachowuje |
threadReplies | PlatformThreadReplies[] | Wątki dla platform, jak przy tworzeniu. Wysłanie listy zastępuje wszystkie zapisane wątki, pusta lista je usuwa, a pominięcie zachowuje |
scheduledAt | string | Nowy 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ę |
timezone | string | Strefa czasowa IANA |
pageIds | string[] | Strony na Facebooku, na których ma się pojawić post. Przyjmuje id konta lub pageId z /social-accounts |
twitterConnectionIds | string[] | Identyfikatory połączeń kont Twitter |
twitterKeepLinks | boolean | Zachowuje klikalne linki w tekście na X, jak przy tworzeniu. Pominięcie zachowuje zapisaną wartość |
linkedinConnectionIds | string[] | Identyfikatory połączeń kont LinkedIn |
instagramConnectionIds | string[] | Identyfikatory połączeń kont Instagram |
tiktokConnectionIds | string[] | Identyfikatory połączeń kont TikTok |
youtubeConnectionIds | string[] | Identyfikatory połączeń kanałów YouTube |
pinterestConnectionIds | string[] | Identyfikatory połączeń kont Pinterest |
blueskyConnectionIds | string[] | Identyfikatory połączeń kont Bluesky |
mastodonConnectionIds | string[] | Identyfikatory połączeń kont Mastodon |
googleBusinessConnectionIds | string[] | Identyfikatory połączeń lokalizacji Google Business Profile |
googleBusinessConfigs | GoogleBusinessConfig[] | 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 |
tumblrConnectionIds | string[] | Identyfikatory połączeń blogów Tumblr |
wordpressConnectionIds | string[] | Identyfikatory połączeń witryn WordPress |
telegramConnectionIds | string[] | Identyfikatory połączeń kanałów i grup Telegram |
tumblrConfigs | TumblrConfig[] | Ustawienia posta Tumblr dla każdego bloga: tagi, tytuł i link do źródła. Schemat opisano w sekcji Konfiguracje platform |
wordpressConfigs | WordPressConfig[] | Ustawienia posta WordPress dla każdej witryny: tytuł, zajawka, kategorie, tagi i status. Schemat opisano w sekcji Konfiguracje platform |
threadsConnectionIds | string[] | Identyfikatory połączeń kont Threads |
pinterestConfigs | PinterestConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
tiktokConfigs | TikTokConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
instagramConfigs | InstagramConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
facebookConfigs | FacebookConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
youtubeConfigs | YouTubeConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
linkedinConfigs | LinkedInConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
twitterConfigs | TwitterConfig[] | 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"
}