Change Post Stage
PATCH
/posts/{postId}/stage/{stage}
publishAt date set before they can be scheduled.Stage Actions
| Stage | Description |
|---|---|
| publishNow | Immediately publish the post to all assigned social networks, bypassing scheduled time. Post must pass validation. |
schedule | Schedule the post for publishing at the configured publishAt time. Post must have a publishAt date set and pass validation. Changes stage to SCHEDULED. |
unschedule | Cancel a previously scheduled post, preventing it from publishing. Changes stage back to DRAFT. |
teamReview | Submit the post for team review. Changes stage to TEAM_REVIEW. Post must pass validation. |
approve | Approve a post that's in review. Available when post is in TEAM_REVIEW or CLIENT_REVIEW stage. Changes stage to TEAM_APPROVED or CLIENT_APPROVED. |
reject | Reject a post that's in review, sending it back for revisions. Changes stage to TEAM_REVISION or CLIENT_REVISION. |
Notes
publishNow and schedule actions trigger validation checks - the post must meet all network requirements.schedule requires the post to have a publishAt date set via POST or PUT endpoints first.publishNow ignores the publishAt date and publishes immediately.unschedule only works on posts in SCHEDULED stage.approve and reject only work on posts in review stages (TEAM_REVIEW, CLIENT_REVIEW).Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.swonkie.dev/v2/posts/UG9zdElkMTIzNDU2Nzg5/stage/schedule' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'Response Response Example
{
"success": true
}Modified at 2026-03-11 19:13:36