Reprogramar Post
Cambia la hora de publicación de un post programado.
Cambia la hora de publicación de un post programado.
/api/v1/post/{postId}Actualiza la hora de publicación programada de un post en estado PENDING.
{
"publishAt": "2027-01-21T15:00:00Z"
}{
"publishAt": "2027-01-21T15:00:00Z"
}| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
publishAt | string | Sí | Nueva hora de publicación como fecha ISO 8601 futura |
timezone | string | No | Override IANA opcional. Sin él se utiliza la zona del workspace. |
curl --request PATCH \
--url https://dopost.co/api/v1/post/<postId> \
--header 'x-api-key: <apiKey>' \
--header 'Content-Type: application/json' \
--data '{ "publishAt": "2027-01-21T15:00:00Z" }'curl --request PATCH \
--url https://dopost.co/api/v1/post/<postId> \
--header 'x-api-key: <apiKey>' \
--header 'Content-Type: application/json' \
--data '{ "publishAt": "2027-01-21T15:00:00Z" }'{
"id": "cm3abc123def456",
"scheduledFor": "2027-01-21T15:00:00.000Z"
}{
"id": "cm3abc123def456",
"scheduledFor": "2027-01-21T15:00:00.000Z"
}Solo los posts en estado PENDING (programados pero aún no publicados) pueden ser reprogramados. Usa Listar Posts con ?status=PENDING para encontrar posts reprogramables.
| Status | Error | Causa |
|---|---|---|
400 | publishAt is required | Falta el campo publishAt |
400 | publishAt must be a valid ISO 8601 date | Cadena de fecha inválida |
400 | publishAt must be a future date | La fecha está en el pasado |
400 | Only PENDING posts can be rescheduled | El post ya fue publicado, falló, o es un borrador |
401 | Invalid or missing API key | Header x-api-key inválido o faltante |
404 | Post not found | El postId no existe en tu workspace |
403 | API key does not have permission for this action | La API key no tiene el scope necesario para este endpoint |
429 | Rate limit exceeded | Demasiadas peticiones. Revisa las cabeceras X-RateLimit-* y reintenta tras el tiempo indicado |
500 | Failed to reschedule with QStash | Error del servicio de programación. La BD fue revertida |
Las fechas y horas sin zona (2027-01-20T10:00:00) se interpretan en la zona horaria IANA del workspace. No hace falta indicarla. Las fechas con Z u offset explícito conservan su instante; dopost hace la conversión y guarda UTC. Una hora local inexistente por cambio de horario se rechaza. Para distinguir dos horas repetidas, incluye un offset explícito.
En publicación y reprogramación puedes enviar timezone como override IANA opcional, por ejemplo Europe/Madrid. En recurrentes, timezone selecciona la zona de la serie y de la fecha inicial; por defecto es la del workspace. Al actualizar una serie se conserva su zona actual. recurrence.endDate representa la fecha de calendario de fin de la serie.