Publicações recorrentes
Liste, consulte, pause, retome e exclua as publicações recorrentes que você criou com recurrence pela API REST do AdaptlyPost.
https://post.adaptlypost.com/post/api/v1/recurring-postsRetorna uma lista paginada das publicações recorrentes do espaço de trabalho. Uma publicação recorrente é uma série que você cria ao enviar recurrence para Criar publicação.
Parâmetros de consulta
| Parametro | Tipo | Descricao |
|---|---|---|
limit | number | Número de publicações recorrentes a retornar (1-100, padrão: 20) |
offset | number | Número de publicações recorrentes a ignorar (padrão: 0) |
statuses | RecurringPostStatus[] | Filtrar por ACTIVE, PAUSED ou ENDED. Repita a chave por valor: statuses=ACTIVE&statuses=PAUSED |
Só a próxima publicação existe
Uma série ativa mantém uma única publicação agendada, a próxima. O AdaptlyPost a cria cerca de 24 horas antes, e ela aparece em Listar publicações com recurringPostId preenchido. Excluir essa publicação com Excluir publicação pula essa data, e a série continua.Campos de uma publicação recorrente
| Campo | Descrição |
|---|---|
id | ID da publicação recorrente. Use com os endpoints abaixo |
userId | O membro que criou a série |
status | ACTIVE cria publicações. PAUSED não cria nenhuma até você retomá-la. ENDED atingiu endsOn ou maxOccurrences |
pauseReason | Por que a série foi pausada. Só aparece quando status é PAUSED. Veja a tabela abaixo |
lastError | O erro que pausou a série, quando uma falha foi a causa |
frequency | DAILY, WEEKLY ou MONTHLY |
interval | Repete a cada N dias, semanas ou meses |
weekdays | Os dias da semana em que uma série WEEKLY publica |
startsAt | Data e hora da primeira publicação. Define o horário de todas as publicações |
timezone | Fuso horário IANA que a série segue |
endsOn | Último dia em que uma publicação pode sair. Não aparece quando a série não tem data final |
maxOccurrences | Número total de publicações da série. Não aparece quando não há limite |
nextOccurrenceAt | A próxima data que ainda não existe como publicação. Não aparece depois que a série termina |
occurrenceCount | Publicações criadas pela série até agora |
contentType | O conteúdo que cada publicação da série usa, como enviado para Criar publicação |
text | O conteúdo que cada publicação da série usa, como enviado para Criar publicação |
mediaUrls | O conteúdo que cada publicação da série usa, como enviado para Criar publicação |
mediaAltTexts | O conteúdo que cada publicação da série usa, como enviado para Criar publicação |
thumbnailUrl | O conteúdo que cada publicação da série usa, como enviado para Criar publicação |
platformTypes | As plataformas em que a série publica |
platforms | As contas em que a série publica, uma entrada por conta. O status delas é sempre PENDING |
Motivos de pausa
Uma série pode se pausar sozinha. Corrija a causa e depois retome a série. Ela continua a partir da próxima data depois de agora.
| Motivo | Descrição |
|---|---|
USER | Alguém a pausou pela API ou pelo app |
CONSECUTIVE_FAILURES | 3 publicações seguidas falharam |
SUBSCRIPTION_INACTIVE | A assinatura do espaço de trabalho não está mais ativa |
ACCESS_LOST | O membro que a criou perdeu o acesso ao espaço de trabalho |
CONNECTION_REMOVED | Alguém desconectou uma das contas dela |
INVALID_CONTENT | Uma plataforma rejeitou o conteúdo |
Gerenciar uma publicação recorrente
https://post.adaptlypost.com/post/api/v1/recurring-posts/:idRetorna uma publicação recorrente. Um ID que não existe ou pertence a outro espaço de trabalho retorna 404.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:id/pausePausa a série. Ela para de criar publicações e exclui a próxima publicação agendada. Retorna a publicação recorrente.
A chave também precisa de posts.schedule. Uma série criada por outro membro precisa também de posts.others.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:id/resumeRetoma uma série pausada a partir da próxima data depois de agora. Datas perdidas durante a pausa não são publicadas. Retorna a publicação recorrente.
A chave também precisa de posts.schedule. Uma série criada por outro membro precisa também de posts.others.
https://post.adaptlypost.com/post/api/v1/recurring-posts/:idExclui a série e a próxima publicação agendada dela. Publicações que já saíram são mantidas. Retorna { "deleted": true }.
A chave também precisa de posts.delete. Uma série criada por outro membro precisa também de 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
}