Posts

Reschedule post

Moves an already-scheduled post to a new publish time, without touching content, media, or approval state.

PATCH/api/public/posts/:id/schedule

cURLPATCH /api/public/posts/:id/schedule

curl -X PATCH https://postiv.ai/api/public/posts/ID_ID/schedule \
  -H "Authorization: Bearer pk_postiv_..." \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledTime": "2026-08-01T09:30:00.000Z"
  }'

200Response

{
  "success": true,
  "post": {
    "id": "post1...",
    "title": "My post",
    "status": "scheduled"
  },
  "newScheduledTime": "2026-07-21T09:00:00.000Z"
}

Authorization

Requires an organization API key with the posts:schedule scope, sent as Authorization: Bearer or x-api-key.

Path parameters

idstringrequired

Resource id from the corresponding list or create endpoint.

Body parameters

scheduledTimestringrequired

ISO-8601, must be >= 2 minutes in the future.

Response

The rescheduled post.

post.id / title / statusmixed

newScheduledTimetimestamp

Errors

400	invalid_scheduled_time: not a valid timestamp or <2 minutes in the future
404	post_not_found / queue_entry_not_found
400	post_not_scheduled