REST APIGET

Posty cykliczne

Wyświetlaj, odczytuj, wstrzymuj, wznawiaj i usuwaj posty cykliczne utworzone przez parametr recurrence w Utwórz post w REST API AdaptlyPost.

GEThttps://post.adaptlypost.com/post/api/v1/recurring-posts

Zwraca listę postów cyklicznych obszaru roboczego z podziałem na strony. Post cykliczny to seria tworzona przez wysłanie recurrence do Utwórz post.

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

Parametry zapytania

ParametrTypOpis
limitnumberLiczba zwracanych postów cyklicznych (1-100, domyślnie: 20)
offsetnumberLiczba pomijanych postów cyklicznych (domyślnie: 0)
statusesRecurringPostStatus[]Filtr według ACTIVE, PAUSED lub ENDED. Klucz należy powtórzyć dla każdej wartości: statuses=ACTIVE&statuses=PAUSED

Istnieje tylko kolejny post

Aktywna seria ma jeden zaplanowany post, czyli kolejny. AdaptlyPost tworzy go około 24 godzin wcześniej i pojawia się on w Lista postów z ustawionym recurringPostId. Usunięcie go przez Usuń post pomija ten termin, a seria trwa dalej.

Pola posta cyklicznego

PoleOpis
idID posta cyklicznego. Używane w poniższych endpointach
userIdCzłonek, który utworzył serię
statusACTIVE tworzy posty. PAUSED nie tworzy ich do czasu wznowienia. ENDED osiągnął endsOn lub maxOccurrences
pauseReasonPrzyczyna wstrzymania serii. Ustawiane tylko przy statusie PAUSED. Zob. tabelę poniżej
lastErrorBłąd, który wstrzymał serię, jeśli przyczyną była awaria
frequencyDAILY, WEEKLY, MONTHLY lub YEARLY
intervalPowtarzanie co N dni, tygodni, miesięcy lub lat
weekdaysDni tygodnia publikacji serii WEEKLY
startsAtData i godzina pierwszego posta. Wyznacza godzinę publikacji wszystkich postów
timezoneStrefa czasowa IANA serii
endsOnOstatni dzień, w którym może się ukazać post. Brak, gdy seria nie ma daty końcowej
maxOccurrencesŁączna liczba postów w serii. Brak, gdy nie ma limitu
nextOccurrenceAtKolejny termin, dla którego nie ma jeszcze posta. Brak po zakończeniu serii
occurrenceCountLiczba postów utworzonych dotąd przez serię
contentTypeTreść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post
textTreść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post
mediaUrlsTreść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post
mediaAltTextsTreść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post
thumbnailUrlTreść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post
platformTypesPlatformy, na których publikuje seria
platformsKonta, na których publikuje seria, po jednym wpisie na konto. Ich status to zawsze PENDING

Przyczyny wstrzymania

Seria może wstrzymać się sama. Po usunięciu przyczyny należy ją wznowić. Będzie kontynuowana od najbliższego przyszłego terminu.

PrzyczynaOpis
USERKtoś wstrzymał ją przez API lub aplikację
CONSECUTIVE_FAILURES3 kolejne posty zakończyły się niepowodzeniem
SUBSCRIPTION_INACTIVESubskrypcja obszaru roboczego nie jest już aktywna
ACCESS_LOSTCzłonek, który ją utworzył, utracił dostęp do obszaru roboczego
CONNECTION_REMOVEDKtoś odłączył jedno z jej kont
INVALID_CONTENTPlatforma odrzuciła treść

Zarządzanie postem cyklicznym

GEThttps://post.adaptlypost.com/post/api/v1/recurring-posts/:id

Zwraca jeden post cykliczny. ID, które nie istnieje lub należy do innego obszaru roboczego, zwraca 404 „Recurring post not found”.

Klucz API (token Bearer)
Uprawnienie:posts.readRole i uprawnienia
POSThttps://post.adaptlypost.com/post/api/v1/recurring-posts/:id/pause

Wstrzymuje serię. Przestaje ona tworzyć posty i usuwa nadchodzący zaplanowany post. Zwraca post cykliczny.

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

Klucz potrzebuje też posts.schedule. Seria utworzona przez innego członka wymaga dodatkowo posts.others.

POSThttps://post.adaptlypost.com/post/api/v1/recurring-posts/:id/resume

Wznawia wstrzymaną serię od najbliższego przyszłego terminu. Terminy pominięte podczas wstrzymania nie są publikowane. Zwraca post cykliczny.

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

Klucz potrzebuje też posts.schedule. Seria utworzona przez innego członka wymaga dodatkowo posts.others.

DELETEhttps://post.adaptlypost.com/post/api/v1/recurring-posts/:id

Usuwa serię i jej nadchodzący zaplanowany post. Opublikowane posty pozostają. Zwraca { "deleted": true }.

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

Klucz potrzebuje też posts.delete. Seria utworzona przez innego członka wymaga dodatkowo posts.others.

Edycja serii i pomijanie późniejszego terminu są dostępne tylko w aplikacji AdaptlyPost. Aby pominąć kolejny termin, należy usunąć jego zaplanowany post.
Lista postów cyklicznych
curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/recurring-posts?limit=10&offset=0&statuses=ACTIVE&statuses=PAUSED' \
  --header 'Authorization: Bearer <api-key>'
Wstrzymanie posta cyklicznego
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/pause \
  --header 'Authorization: Bearer <api-key>'
Wznowienie posta cyklicznego
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/resume \
  --header 'Authorization: Bearer <api-key>'
Usunięcie posta cyklicznego
curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123 \
  --header 'Authorization: Bearer <api-key>'
200
{
  "recurringPosts": [
    {
      "id": "rp_abc123",
      "userId": "user_123",
      "status": "ACTIVE",
      "frequency": "WEEKLY",
      "interval": 1,
      "weekdays": ["MONDAY", "THURSDAY"],
      "startsAt": "2026-10-05T13:00:00.000Z",
      "timezone": "America/New_York",
      "maxOccurrences": 12,
      "nextOccurrenceAt": "2026-10-19T13:00:00.000Z",
      "occurrenceCount": 4,
      "contentType": "TEXT",
      "text": "{Hi|Hello} everyone, the weekly product tip is live!",
      "mediaUrls": [],
      "platformTypes": ["LINKEDIN"],
      "platforms": [
        {
          "id": "rp_abc123-0",
          "platform": "LINKEDIN",
          "status": "PENDING"
        }
      ],
      "createdAt": "2026-10-01T09:30:00.000Z",
      "updatedAt": "2026-10-14T13:00:00.000Z"
    }
  ],
  "total": 1,
  "hasMore": false
}