API reference
Change when a scheduled post publishes.
https://api.betterpost.dev/v1/posts/scheduled/{id}Only the time changes; content, targets and credits stay as they are.
| Name | Description |
|---|---|
id | The post id. The post must be scheduled. |
| Field | Type | Required | Description |
|---|---|---|---|
scheduledFor | string | Yes | New ISO 8601 date-time in the future. Without an offset it is read in timezone. |
timezone | string | No | IANA time zone. Default: the post's current one. |
curl -s -X PATCH https://api.betterpost.dev/v1/posts/scheduled/post_8f3k2m9q1x7v4n6b0c5d2a1z \
-H "x-access-key: $BETTERPOST_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "scheduledFor": "2026-11-04T10:30:00", "timezone": "America/Chicago" }'200 OK
{ "success": true, "message": "Post rescheduled.", "scheduledFor": "2026-11-04T16:30:00.000Z" }| Status | Code | When |
|---|---|---|
200 | The post was rescheduled. | |
400 | validation_error | scheduledFor is missing. |
400 | invalid_timezone, invalid_scheduled_for, scheduled_in_past | Bad time or time zone. |
401 | unauthorized | Missing or unknown API key. |
404 | not_found | No such post in this project. |
409 | not_scheduled | The post is not scheduled. |
429 | rate_limited | More than 120 requests per minute. |