PATCH/v1/posts/{id}

reschedulePost

Reschedule a post. Moves a draft, scheduled, or failed post to a new future publish time (drafts must already have variants). Published, publishing, and approval-pending posts cannot be rescheduled (409 `resource_conflict`).

Required scope:posts:write

Parameters

idpath · stringrequired

Post identifier.

Request body

scheduled_atstring (ISO-8601)required

The new future publish time (ISO-8601).

Depth-limited view — the interactive reference has every nested schema.

Responses

200Post

The rescheduled post.

400invalid_request validation_failed

401authentication_required invalid_api_key

403insufficient_scope feature_not_enabled

404resource_not_found

409resource_conflict

429rate_limited quota_exhausted

500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

PATCH /v1/posts/{id}

curl -X PATCH https://app.usepostify.com/v1/posts/post_9x2y3z0001 \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
  "scheduled_at": "2026-08-02T15:30:00Z"
}'