changedInput schema / properties / caption / description
Previous value: -"The caption that is published with the post."New value: +"The caption published with the post, at most 5,000 characters. Each platform's own length limit is checked when it is scheduled."
changedInput schema / properties / instagram_trial_reel / description
Previous value: -"true: post the video to Instagram as a TRIAL reel, shown first to people who do not follow the account and not on the profile grid. One video only, not a Story. false takes it off."New value: +"Instagram only, one video, not a Story. true: post it as a TRIAL reel, shown first to people who do not follow the account and not on the profile grid. false takes that off."
changedInput schema / properties / keyword / description
Previous value: -"The call-to-action word people comment to get a DM, for example \"GUIDE\". Letters, digits, _ and - only."New value: +"The call-to-action word people comment to get a DM, for example \"GUIDE\". Letters, digits, _ and - only, at most 40. It is a label on the post; the DM itself is sent by a live automation with the same keyword (postkey_create_automation)."
changedInput schema / properties / library_item_ids / description
Previous value: -"The media of the post, in order, by id from postkey_list_library."New value: +"The post's media in order: ids from postkey_list_library or postkey_finish_upload. Up to 10 (a story takes exactly 1). Sending it replaces the list; an empty list removes all."
changedInput schema / properties / link_url / description
Previous value: -"The link the keyword automation hands out (https://...)."New value: +"The link the keyword automation hands out, https://..."
changedInput schema / properties / platform_settings / description
Previous value: -"Each platform's own settings, keyed by platform, set key by key over what the post has (null takes one off). For example { \"tiktok\": { \"privacy_status\": \"private\", \"allow_duet\": false }, \"instagram\": { \"share_to_feed\": false, \"first_comment\": \"Link in bio\" }, \"linkedin\": { \"first_comment\": \"...\" }, \"reddit\": { \"subreddit\": \"videography\", \"title\": \"...\" } }. postkey_guide topic platforms lists every setting and what it takes. An unknown platform or setting is refused."New value: +"Each platform's own settings, keyed by platform, merged key by key into what the post has (null removes one). For example { \"tiktok\": { \"privacy_status\": \"private\", \"allow_duet\": false }, \"instagram\": { \"share_to_feed\": false, \"first_comment\": \"Link in bio\" }, \"linkedin\": { \"first_comment\": \"...\" }, \"reddit\": { \"subreddit\": \"videography\", \"title\": \"...\" } }. postkey_guide topic platforms lists every setting and what it takes. An unknown platform or setting is refused invalid_arguments."
changedInput schema / properties / social_account_ids / description
Previous value: -"The social accounts to post to, by id from postkey_list_social_accounts."New value: +"The social accounts to post to: ids from postkey_list_social_accounts (active, not needs_reconnect). Up to 30. Sending it replaces the list; an empty list removes all."
changedInput schema / properties / title / description
Previous value: -"An internal title only your team sees. Never published."New value: +"An internal title only the team sees. Never published. At most 200 characters."
changedInput schema / properties / trial_graduation / description
Previous value: -"With instagram_trial_reel true: \"manual\" (default) the person shares it to their followers in Instagram; \"by_performance\" Instagram shares it by itself if it does well."New value: +"Only with instagram_trial_reel true. \"manual\" (default): the person shares it to their followers in Instagram; \"by_performance\": Instagram shares it by itself if it does well."
changedInput schema / properties / type / description
Previous value: -"The kind of post."New value: +"\"text\": words only (Instagram, TikTok, YouTube and Pinterest do not take it). \"image\": one or more images (not YouTube). \"video\": a video. \"story\": exactly one image or video as an Instagram or Facebook Story."
changedInput schema / properties / visibility / description
Previous value: -"Who can see the video on YouTube (only YouTube uses this). \"unlisted\": anyone with the link, not in search or on the channel. Default public."New value: +"YouTube only: who can see the video. \"public\" (default); \"unlisted\": anyone with the link, not in search or on the channel; \"private\": only the channel."
changedInput schema / properties / youtube_title / description
Previous value: -"The YouTube video's title, at most 100 characters. Without one, YouTube uses the first 100 characters of the caption. Send an empty string to remove it."New value: +"YouTube only: the video's title, at most 100 characters. Left out: YouTube uses the first 100 characters of the caption. An empty string removes it."
changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "additionalProperties": true,
+ "properties": {
+ "created": {
+ "description": "true: the draft was made.",
+ "type": "boolean"
+ },
+ "note": {
+ "description": "The next steps.",
+ "type": "string"
+ },
+ "ok": {
+ "description": "false: refused (isError true; code, message, guide_topic, url), nothing changed.",
+ "type": "boolean"
+ },
+ "post_id": {
+ "description": "The post id.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "posts_left_this_week": {
+ "description": "On a plan with a weekly post limit: posts left this week.",
+ "type": "number"
+ },
+ "published": {
+ "description": "Always false: nothing was published.",
+ "type": "boolean"
+ },
+ "status": {
+ "description": "The post's status after the save.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "warnings": {
+ "description": "Things to fix before it can be sent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "ok"
+ ],
+ "type": "object"
+}