Skip to main content

Update a post

PUT 
/:workspace/posts/:post

Replaces the post's accounts, tags and versions (existing versions are removed and recreated from the request) and recomputes the scheduled date and time from date + time.

Caveats — differences from creating a post​

  • timezone is ignored. Unlike creation, this endpoint does not apply timezone when interpreting date and time. The field is accepted, but has no effect.
  • schedule, schedule_now and queue have no effect. They are accepted by validation for consistency with post creation, but this endpoint does not read them.
  • The status is never changed by this endpoint. Only the scheduled date and time is updated. Use POST /posts/schedule/{post}, POST /posts/add-to-queue/{post} or POST /posts/approve/{post} to change a post's status.
  • If the post is not a draft and either accounts is empty or date and time are not both present, the post is moved back to draft.

Returns 422 when the post is already in history (published or failed) or is currently being published.

Request​

Responses​

Update result.