REST APIGET

Publicaciones recurrentes

Lista, consulta, pausa, reanuda y elimina las publicaciones recurrentes que creaste con recurrence mediante la API REST de AdaptlyPost.

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

Devuelve una lista paginada de las publicaciones recurrentes del espacio de trabajo. Una publicación recurrente es una serie que creas al enviar recurrence a Crear publicación.

Clave API (token Bearer)

Permiso:posts.readRoles y permisos

Parámetros de consulta

Parametro	Tipo	Descripcion
`limit`	`number`	Número de publicaciones recurrentes a devolver (1-100, predeterminado: 20)
`offset`	`number`	Número de publicaciones recurrentes a omitir (predeterminado: 0)
`statuses`	`RecurringPostStatus[]`	Filtrar por ACTIVE, PAUSED o ENDED. Repite la clave por cada valor: statuses=ACTIVE&statuses=PAUSED

Solo existe la siguiente publicación

Una serie activa tiene una sola publicación programada, la siguiente. AdaptlyPost la crea unas 24 horas antes, y aparece en Listar publicaciones con recurringPostId. Si eliminas esa publicación con Eliminar publicación, esa fecha se omite y la serie continúa.

Campos de una publicación recurrente

Campo	Descripción
`id`	ID de la publicación recurrente. Úsalo con los endpoints de abajo
`userId`	El miembro que creó la serie
`status`	ACTIVE crea publicaciones. PAUSED no crea ninguna hasta que la reanudes. ENDED llegó a endsOn o maxOccurrences
`pauseReason`	Por qué se pausó la serie. Solo aparece cuando status es PAUSED. Consulta la tabla de abajo
`lastError`	El error que pausó la serie, cuando la causa fue un fallo
`frequency`	DAILY, WEEKLY o MONTHLY
`interval`	Se repite cada N días, semanas o meses
`weekdays`	Los días de la semana en que publica una serie WEEKLY
`startsAt`	Fecha y hora de la primera publicación. Fija la hora del día de todas las publicaciones
`timezone`	Zona horaria IANA que sigue la serie
`endsOn`	Último día en que puede salir una publicación. No aparece si la serie no tiene fecha de fin
`maxOccurrences`	Número total de publicaciones de la serie. No aparece si no hay límite
`nextOccurrenceAt`	La siguiente fecha que aún no existe como publicación. No aparece cuando la serie ha terminado
`occurrenceCount`	Publicaciones creadas por la serie hasta ahora
`contentType`	El contenido que usa cada publicación de la serie, tal como se envió a Crear publicación
`text`	El contenido que usa cada publicación de la serie, tal como se envió a Crear publicación
`mediaUrls`	El contenido que usa cada publicación de la serie, tal como se envió a Crear publicación
`mediaAltTexts`	El contenido que usa cada publicación de la serie, tal como se envió a Crear publicación
`thumbnailUrl`	El contenido que usa cada publicación de la serie, tal como se envió a Crear publicación
`platformTypes`	Las plataformas en las que publica la serie
`platforms`	Las cuentas en las que publica la serie, una entrada por cuenta. Su status siempre es PENDING

Motivos de pausa

Una serie puede pausarse sola. Corrige la causa y luego reanúdala. Continúa desde la siguiente fecha a partir de ahora.

Motivo	Descripción
`USER`	Alguien la pausó desde la API o la app
`CONSECUTIVE_FAILURES`	Fallaron 3 publicaciones seguidas
`SUBSCRIPTION_INACTIVE`	La suscripción del espacio de trabajo ya no está activa
`ACCESS_LOST`	El miembro que la creó perdió el acceso al espacio de trabajo
`CONNECTION_REMOVED`	Alguien desconectó una de sus cuentas
`INVALID_CONTENT`	Una plataforma rechazó el contenido

Gestionar una publicación recurrente

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

Devuelve una publicación recurrente. Un ID que no existe o que pertenece a otro espacio de trabajo devuelve 404.

Clave API (token Bearer)

Permiso:posts.readRoles y permisos

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

Pausa la serie. Deja de crear publicaciones y elimina su próxima publicación programada. Devuelve la publicación recurrente.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

La clave también necesita posts.schedule. Una serie creada por otro miembro necesita además posts.others.

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

Reanuda una serie pausada desde la siguiente fecha a partir de ahora. Las fechas perdidas durante la pausa no se publican. Devuelve la publicación recurrente.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

La clave también necesita posts.schedule. Una serie creada por otro miembro necesita además posts.others.

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

Elimina la serie y su próxima publicación programada. Las publicaciones que ya salieron se conservan. Devuelve { "deleted": true }.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

La clave también necesita posts.delete. Una serie creada por otro miembro necesita además posts.others.

Editar una serie y omitir una fecha posterior solo es posible en la app de AdaptlyPost. Para omitir la siguiente fecha, elimina su publicación programada.

Listar publicaciones recurrentes

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

Pausar una publicación recurrente

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

Reanudar una publicación recurrente

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

Eliminar una publicación recurrente

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
}