Posty cykliczne
Wyświetlaj, odczytuj, wstrzymuj, wznawiaj i usuwaj posty cykliczne utworzone przez parametr recurrence w Utwórz post w REST API AdaptlyPost.
https://post.adaptlypost.com/post/api/v1/recurring-postsZwraca listę postów cyklicznych obszaru roboczego z podziałem na strony. Post cykliczny to seria tworzona przez wysłanie recurrence do Utwórz post.
Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
limit | number | Liczba zwracanych postów cyklicznych (1-100, domyślnie: 20) |
offset | number | Liczba pomijanych postów cyklicznych (domyślnie: 0) |
statuses | RecurringPostStatus[] | 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
| Pole | Opis |
|---|---|
id | ID posta cyklicznego. Używane w poniższych endpointach |
userId | Członek, który utworzył serię |
status | ACTIVE tworzy posty. PAUSED nie tworzy ich do czasu wznowienia. ENDED osiągnął endsOn lub maxOccurrences |
pauseReason | Przyczyna wstrzymania serii. Ustawiane tylko przy statusie PAUSED. Zob. tabelę poniżej |
lastError | Błąd, który wstrzymał serię, jeśli przyczyną była awaria |
frequency | DAILY, WEEKLY, MONTHLY lub YEARLY |
interval | Powtarzanie co N dni, tygodni, miesięcy lub lat |
weekdays | Dni tygodnia publikacji serii WEEKLY |
startsAt | Data i godzina pierwszego posta. Wyznacza godzinę publikacji wszystkich postów |
timezone | Strefa czasowa IANA serii |
endsOn | Ostatni 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 |
nextOccurrenceAt | Kolejny termin, dla którego nie ma jeszcze posta. Brak po zakończeniu serii |
occurrenceCount | Liczba postów utworzonych dotąd przez serię |
contentType | Treść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post |
text | Treść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post |
mediaUrls | Treść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post |
mediaAltTexts | Treść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post |
thumbnailUrl | Treść używana przez wszystkie posty serii, tak jak wysłana do Utwórz post |
platformTypes | Platformy, na których publikuje seria |
platforms | Konta, 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.
| Przyczyna | Opis |
|---|---|
USER | Ktoś wstrzymał ją przez API lub aplikację |
CONSECUTIVE_FAILURES | 3 kolejne posty zakończyły się niepowodzeniem |
SUBSCRIPTION_INACTIVE | Subskrypcja obszaru roboczego nie jest już aktywna |
ACCESS_LOST | Członek, który ją utworzył, utracił dostęp do obszaru roboczego |
CONNECTION_REMOVED | Ktoś odłączył jedno z jej kont |
INVALID_CONTENT | Platforma odrzuciła treść |
Zarządzanie postem cyklicznym
https://post.adaptlypost.com/post/api/v1/recurring-posts/:idZwraca jeden post cykliczny. ID, które nie istnieje lub należy do innego obszaru roboczego, zwraca 404 „Recurring post not found”.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:id/pauseWstrzymuje serię. Przestaje ona tworzyć posty i usuwa nadchodzący zaplanowany post. Zwraca post cykliczny.
Klucz potrzebuje też posts.schedule. Seria utworzona przez innego członka wymaga dodatkowo posts.others.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:id/resumeWznawia wstrzymaną serię od najbliższego przyszłego terminu. Terminy pominięte podczas wstrzymania nie są publikowane. Zwraca post cykliczny.
Klucz potrzebuje też posts.schedule. Seria utworzona przez innego członka wymaga dodatkowo posts.others.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:idUsuwa serię i jej nadchodzący zaplanowany post. Opublikowane posty pozostają. Zwraca { "deleted": true }.
Klucz potrzebuje też posts.delete. Seria utworzona przez innego członka wymaga dodatkowo posts.others.
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>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/pause \
--header 'Authorization: Bearer <api-key>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/resume \
--header 'Authorization: Bearer <api-key>'curl --request DELETE \
--url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123 \
--header 'Authorization: Bearer <api-key>'{
"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
}