REST APIGET

Wiederkehrende Beiträge

Wiederkehrende Beiträge, die Sie mit recurrence erstellt haben, über die AdaptlyPost REST API auflisten, pausieren, fortsetzen und löschen.

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

Gibt eine paginierte Liste der wiederkehrenden Beiträge des Workspace zurück. Ein wiederkehrender Beitrag ist eine Serie, die Sie erstellen, indem Sie recurrence an Beitrag erstellen senden.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.readRollen und Berechtigungen

Abfrageparameter

Parameter	Typ	Beschreibung
`limit`	`number`	Anzahl der zurückzugebenden wiederkehrenden Beiträge (1-100, Standard: 20)
`offset`	`number`	Anzahl der zu überspringenden wiederkehrenden Beiträge (Standard: 0)
`statuses`	`RecurringPostStatus[]`	Nach ACTIVE, PAUSED oder ENDED filtern. Schlüssel pro Wert wiederholen: statuses=ACTIVE&statuses=PAUSED

Nur der nächste Beitrag existiert

Eine aktive Serie hat genau einen geplanten Beitrag, den nächsten. AdaptlyPost erstellt ihn etwa 24 Stunden vorher, und er erscheint in Beiträge auflisten mit gesetzter recurringPostId. Wenn Sie diesen Beitrag mit Beitrag löschen entfernen, entfällt der Termin und die Serie läuft weiter.

Felder eines wiederkehrenden Beitrags

Feld	Beschreibung
`id`	ID des wiederkehrenden Beitrags. Verwenden Sie sie mit den Endpunkten unten
`userId`	Das Mitglied, das die Serie erstellt hat
`status`	ACTIVE erstellt Beiträge. PAUSED erstellt keine, bis Sie die Serie fortsetzen. ENDED hat endsOn oder maxOccurrences erreicht
`pauseReason`	Warum die Serie pausiert ist. Nur gesetzt, wenn status PAUSED ist. Siehe Tabelle unten
`lastError`	Der Fehler, der die Serie pausiert hat, wenn ein Fehlschlag der Grund war
`frequency`	DAILY, WEEKLY oder MONTHLY
`interval`	Wiederholt sich alle N Tage, Wochen oder Monate
`weekdays`	Die Wochentage, an denen eine WEEKLY-Serie postet
`startsAt`	Datum und Uhrzeit des ersten Beitrags. Die Uhrzeit gilt für jeden Beitrag
`timezone`	IANA-Zeitzone, der die Serie folgt
`endsOn`	Letzter Tag, an dem ein Beitrag erscheinen darf. Fehlt, wenn die Serie kein Enddatum hat
`maxOccurrences`	Gesamtzahl der Beiträge, die die Serie veröffentlicht. Fehlt, wenn es kein Limit gibt
`nextOccurrenceAt`	Der nächste Termin, der noch nicht als Beitrag existiert. Fehlt, sobald die Serie beendet ist
`occurrenceCount`	Bisher von der Serie erstellte Beiträge
`contentType`	Der Inhalt, den jeder Beitrag der Serie verwendet, so wie er an Beitrag erstellen gesendet wurde
`text`	Der Inhalt, den jeder Beitrag der Serie verwendet, so wie er an Beitrag erstellen gesendet wurde
`mediaUrls`	Der Inhalt, den jeder Beitrag der Serie verwendet, so wie er an Beitrag erstellen gesendet wurde
`mediaAltTexts`	Der Inhalt, den jeder Beitrag der Serie verwendet, so wie er an Beitrag erstellen gesendet wurde
`thumbnailUrl`	Der Inhalt, den jeder Beitrag der Serie verwendet, so wie er an Beitrag erstellen gesendet wurde
`platformTypes`	Die Plattformen, auf denen die Serie postet
`platforms`	Die Konten, auf denen die Serie postet, ein Eintrag pro Konto. Ihr status ist immer PENDING

Pausengründe

Eine Serie kann sich selbst pausieren. Beheben Sie die Ursache und setzen Sie die Serie dann fort. Sie läuft ab dem nächsten Termin nach jetzt weiter.

Grund	Beschreibung
`USER`	Jemand hat sie über die API oder die App pausiert
`CONSECUTIVE_FAILURES`	3 Beiträge nacheinander sind fehlgeschlagen
`SUBSCRIPTION_INACTIVE`	Das Abonnement des Workspace ist nicht mehr aktiv
`ACCESS_LOST`	Das Mitglied, das sie erstellt hat, hat keinen Zugriff mehr auf den Workspace
`CONNECTION_REMOVED`	Jemand hat eines ihrer Konten getrennt
`INVALID_CONTENT`	Eine Plattform hat den Inhalt abgelehnt

Einen wiederkehrenden Beitrag verwalten

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

Gibt einen wiederkehrenden Beitrag zurück. Eine ID, die nicht existiert oder zu einem anderen Workspace gehört, liefert 404.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.readRollen und Berechtigungen

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

Pausiert die Serie. Sie erstellt keine Beiträge mehr und löscht ihren nächsten geplanten Beitrag. Gibt den wiederkehrenden Beitrag zurück.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.draftRollen und Berechtigungen

Der Schlüssel braucht zusätzlich posts.schedule. Eine Serie eines anderen Mitglieds braucht außerdem posts.others.

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

Setzt eine pausierte Serie ab dem nächsten Termin nach jetzt fort. Termine aus der Pause werden nicht veröffentlicht. Gibt den wiederkehrenden Beitrag zurück.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.draftRollen und Berechtigungen

Der Schlüssel braucht zusätzlich posts.schedule. Eine Serie eines anderen Mitglieds braucht außerdem posts.others.

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

Löscht die Serie und ihren nächsten geplanten Beitrag. Bereits veröffentlichte Beiträge bleiben erhalten. Gibt { "deleted": true } zurück.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.draftRollen und Berechtigungen

Der Schlüssel braucht zusätzlich posts.delete. Eine Serie eines anderen Mitglieds braucht außerdem posts.others.

Eine Serie bearbeiten und einen späteren Termin überspringen geht nur in der AdaptlyPost-App. Um den nächsten Termin zu überspringen, löschen Sie seinen geplanten Beitrag.

Wiederkehrende Beiträge auflisten

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>'

Einen wiederkehrenden Beitrag pausieren

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/pause \
  --header 'Authorization: Bearer <api-key>'

Einen wiederkehrenden Beitrag fortsetzen

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/recurring-posts/rp_abc123/resume \
  --header 'Authorization: Bearer <api-key>'

Einen wiederkehrenden Beitrag löschen

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
}