Update a scheduled post
Update fields on a scheduled / draft post — all fields are optional. `status` may only be set to `DRAFT` here (the `REJECTED → DRAFT` creator iteration); all other transitions go through the dedicated lifecycle endpoints. Channel and superpower validation matches create.
/scheduled-posts/{scheduledPostId}Beta
Authorization
x-api-key x-date x-signature x-api-version Your API key (the ApiKeys document id).
In: header
Current timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.
In: header
HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.
In: header
API version you're coding against — currently 1. Required; a missing or unsupported value returns 400 with Missing or unsupported x-api-version header. Supported versions: 1.
In: header
Path Parameters
The scheduled post id.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Update a scheduled post. All fields optional.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
Try it
live — writes real dataKept in this tab only and signed in your browser — your secret never leaves your device.
Path
Body (JSON)
This sends a real PATCH to your live organization.
Enter your key and secret to send.
curl -X PATCH "https://example.com/scheduled-posts/AbC123XyZ" \ -H "Content-Type: application/json" \ -d '{ "scheduledFor": "2026-07-02T09:00:00.000Z", "channels": { "FB_PAGE_123456789012345": { "mediumType": "FB_PAGE", "caption": "Updated caption ✏️" } } }'{ "_fsDocScope": "MODEL", "selfPath": "Organization/ORG123/scheduledPublications/AbC123XyZ", "id": "AbC123XyZ", "docName": "FsDocScheduledPublication", "docVer": 1, "created": { "_seconds": 1781840702, "_nanoseconds": 612000000 }, "updated": { "_seconds": 1781840702, "_nanoseconds": 612000000 }, "type": "POST", "media": "https://res.cloudinary.com/demo/image/upload/sample.png", "mediaType": "IMAGE", "scheduledFor": "2026-12-01T12:00:00.000Z", "mediumsData": { "FB_PAGE_1234567890": { "caption": "Big launch this weekend — comment FLASH for early access ⚡️", "mediumType": "FB_PAGE" } }, "status": "DRAFT"}{ "message": "string"}{ "message": "string"}{ "message": "string"}{ "message": "string"}{ "message": "string", "conflicts": [ { "mediumId": "string", "hashtag": "string", "reason": "already-in-use" } ]}{ "error": [ { "message": "string", "path": [ "string" ], "type": "string", "context": {} } ]}