Set post recurrence
Makes a scheduled post repeat: every interval frequency, times more times after this one. Each occurrence keeps the same local time in the channel’s time zone. The post must be scheduled with a time, else 422 on post: Only scheduled posts can repeat. The last occurrence must be before 2038 in every channel’s time zone, else 422 on times.
Authorizations
Workspace API key from Settings → API Keys.
Path Parameters
Post id. A post of another workspace returns 404.
Body
Response
The post with its repeat rule.
A post on one channel. Posts created together from several channels are independent posts that share a post_group_id.
Shared by the posts created in one batch.
A workspace member. Only the id and name are exposed.
Post text, stored as sent (posts written in the app hold the editor's HTML).
Lifecycle of the post in PostClean. pending_approval is a post a member who needs approval asked to schedule or publish. The outcome on the network is publish_status.
draft, pending_approval, scheduled, publishing, published, failed queue: the post holds a slot of the channel's posting schedule. custom: it is scheduled at its own time.
queue, custom, null UTC, format Y-m-d H:i:s.
UTC, format Y-m-d H:i:s.
Who asked for approval (not always the author).
UTC, format Y-m-d H:i:s.
A workspace member. Only the id and name are exposed.
UTC, format Y-m-d H:i:s.
Repeat rule, or null.
network for posts imported from the network (published outside PostClean).
trypost, network Publishing state on the network. pending until the post is sent; retrying waits for a retry after a network limit or a temporary network problem (such as a LinkedIn post not yet ready for its comment); pending_review and rejected come from networks that review posts (Google Business).
pending, publishing, retrying, pending_review, published, failed, rejected Network of the post's channel.
linkedin, linkedin-page, x, tiktok, youtube, facebook, instagram, instagram-facebook, threads, pinterest, bluesky, mastodon, telegram, discord, google_business Post format on one network. It must belong to the destination's network. GET /content-types lists the formats of each network with their media rules. Instagram and Facebook stories publish no text. An X poll (x_poll) takes no media; its choices and length are in meta.poll.
instagram_feed, instagram_reel, instagram_story, linkedin_post, linkedin_page_post, facebook_post, facebook_reel, facebook_story, tiktok_video, tiktok_photo, youtube_short, x_post, x_poll, threads_post, threads_ghost_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message, google_business_post Stored per-network settings (see PlatformMeta). Empty settings may serialize as an empty array.
Link to the published post on the network.
Why publishing failed, when it did.
Account name, kept even after the account is disconnected.
The account, or null once it was removed (the display_* fields keep its name).
UTC, format Y-m-d H:i:s.
UTC, format Y-m-d H:i:s.