List Recurring Posts
List recurring post series in the workspace.
List recurring post series in the workspace.
/api/v1/recurring-postList recurring series and their latest state.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | ACTIVE | PAUSED | COMPLETED | No | Filter by lifecycle status. |
curl --request GET \
--url 'https://dopost.co/api/v1/recurring-post?status=ACTIVE' \
--header 'x-api-key: <apiKey>'curl --request GET \
--url 'https://dopost.co/api/v1/recurring-post?status=ACTIVE' \
--header 'x-api-key: <apiKey>'{
"recurringPosts": [
{
"id": "cm_recurring_123",
"status": "ACTIVE",
"frequency": "WEEKLY",
"interval": 1,
"weekdays": [5],
"timezone": "Europe/Madrid",
"nextRunAt": "2026-09-25T10:00:00.000Z",
"contentPreview": "A useful weekly update from dopost",
"accounts": [
{
"id": "cm_account_123",
"platform": "MASTODON",
"platformUsername": "dopost"
}
]
}
]
}{
"recurringPosts": [
{
"id": "cm_recurring_123",
"status": "ACTIVE",
"frequency": "WEEKLY",
"interval": 1,
"weekdays": [5],
"timezone": "Europe/Madrid",
"nextRunAt": "2026-09-25T10:00:00.000Z",
"contentPreview": "A useful weekly update from dopost",
"accounts": [
{
"id": "cm_account_123",
"platform": "MASTODON",
"platformUsername": "dopost"
}
]
}
]
}Use the returned id with Update Recurring Post.
Use list_recurring_posts. It accepts the same optional status filter.