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.

A scheduled post that stays scheduled — accounts is not empty and date and time are both present — is checked against the publishing requirements of its accounts' platforms, using the accounts and versions in the request. When a requirement is not met, the response is 422 and nothing is changed. A draft, and a post this request moves back to draft, are not checked.

Request​

Responses​

Update result.