Schedule the expected revision at an explicit future time, only when the user requests scheduling. Mandatory team approval remains in force; inspect the returned approval state. Never publishes immediately. Reuse the idempotency key on retries. X automatically reserves the required workspace credits when scheduling succeeds. Insufficient credits leave the post unscheduled; drafts or pending approvals are not scheduled posts. Required scope: posts:schedule.

post/posts/{postId}/schedule

Request

  • Base URL: https://api.publinio.com/v1
  • URL: https://api.publinio.com/v1/posts/{postId}/schedule
  • Auth: HTTP bearer

Path parameters

postIdstring uuid required

Headers

Idempotency-Keystring required

Request body

revisioninteger required
scheduledAtstring date-time required

Response

Result; lists contain data and nextCursor. Posts report their actual status and approval_state.

idstring uuid required
statusstring required
revisioninteger required
approval_statestring
scheduled_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.