Update post
PUT/:workspaceUuid/posts/:postUuid
Replaces a post's versions, accounts, tags, and scheduling options. The post must not be in a published state.
timezone is honoured: date, time and accounts_schedule are read in it. When the post stays
scheduled, provider requirements are validated and reported as 422.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
Post updated. warnings lists non-blocking problems (see PostWarning); the key is absent when there are none.
Missing or invalid API token.
Access denied. Returned when the caller is not a member of the workspace, lacks the role
the endpoint needs, or the workspace's plan does not include API access (capability api).
Resource not found.
Either the content duplicates a post created for the same account within the duplicate window
(code: duplicate_post, existing_post_uuid names it; resend with allow_duplicate: true to post anyway),
or a request with the same Idempotency-Key is still in progress (no code, Retry-After: 1).
Validation failed (errors lists the fields), the Idempotency-Key was already used with a different
body, or the post is scheduled to an account that cannot publish (code: account_unauthorized or
account_token_missing, reconnect the account).
Scheduling would exceed an account's daily post cap for that UTC day (code: account_daily_cap_reached), or the workspace's monthly X allowance (code: x_monthly_cap_reached).