uplika

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "approve": {
      "type": "boolean",
      "description": "Default true."
    },
    "replyId": {
      "type": "string",
      "description": "Omit to list the pending queue instead."
    },
    "accountId": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "accountId": {
      "type": "string",
      "description": "Limit to one Naver Blog account. Omit to cover every connected Naver Blog account."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "accountId",
    "params",
    "templateId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "description": "The template's params."
    },
    "enabled": {
      "type": "boolean",
      "description": "Default false."
    },
    "accountId": {
      "type": "string",
      "description": "Connected account id from list_accounts."
    },
    "templateId": {
      "type": "string",
      "description": "Template id from list_automation_templates."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "accountId",
    "deliver",
    "message",
    "post"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "post": {
      "description": "Our post id, the platform post id, a link to the post, \"any\", or \"next\"."
    },
    "match": {
      "enum": [
        "contains",
        "is",
        "whole_word",
        "begins_with",
        "thumbs_up",
        "not_contains"
      ],
      "type": "string"
    },
    "deliver": {
      "type": "object",
      "properties": {
        "link": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "mediaId": {
          "type": "string"
        },
        "mediaKind": {
          "enum": [
            "file",
            "image",
            "video"
          ],
          "type": "string"
        }
      },
      "description": "What to send after the tap: text, link, and/or a media id."
    },
    "enabled": {
      "type": "boolean",
      "description": "Default false. Prefer leaving it off and calling enable_automation after the person confirms."
    },
    "message": {
      "type": "string",
      "description": "The private reply. One message."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Trigger words in the comment. Empty means every comment."
    },
    "accountId": {
      "type": "string",
      "description": "Connected Instagram or Facebook account id from list_accounts."
    },
    "buttonTitle": {
      "type": "string",
      "description": "Button under the private reply, at most 20 characters."
    },
    "publicReply": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional public replies under the comment; one is picked at random."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    },
    "recheckTitle": {
      "type": "string"
    },
    "requireFollow": {
      "type": "boolean",
      "description": "Instagram only. Deliver only to followers; others are asked to follow and check again."
    },
    "notFollowingMessage": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "postId",
    "replyId"
  ],
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post the reply sits under. A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "replyId": {
      "type": "string",
      "description": "Reply id from list_replies"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "blog"
  ],
  "properties": {
    "blog": {
      "type": "string",
      "description": "The blog to follow: its id (the part after blog.naver.com/) or any link to it."
    },
    "mutual": {
      "type": "boolean",
      "description": "true for a mutual-neighbor request. Default false."
    },
    "message": {
      "type": "string",
      "description": "Message sent with a mutual request. Naver shows it to the other blog. Ignored otherwise."
    },
    "accountId": {
      "type": "string",
      "description": "Which connected account to act as. Only needed when the workspace has more than one Naver Blog."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Automation id from list_automations."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "refresh": {
      "type": "boolean",
      "description": "Re-read the profile from the channel first."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "The connected account to ask about. Required: these values are per account."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "accountId": {
      "type": "string",
      "description": "Limit to one account. Omit to cover every connected channel."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "postId",
    "replyId"
  ],
  "properties": {
    "hide": {
      "type": "boolean",
      "description": "true hides it, false shows it again. Defaults to true."
    },
    "postId": {
      "type": "string",
      "description": "The post the reply sits under. A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "replyId": {
      "type": "string",
      "description": "Reply id from list_replies"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here. On Naver Blog a link to someone else's post works too."
    },
    "replyTo": {
      "type": "string",
      "description": "Reply id from list_replies to like that reply instead of the post."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "before": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "1-100, defaults to 25"
    },
    "accountId": {
      "type": "string",
      "description": "Limit to one account. Omit to cover every connected channel."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "dm",
        "mention"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "state": {
      "enum": [
        "open",
        "closed"
      ],
      "type": "string"
    },
    "search": {
      "type": "string"
    },
    "unread": {
      "type": "boolean"
    },
    "accountId": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "unread": {
      "type": "boolean"
    },
    "accountId": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "scheduled"
      ],
      "type": "string",
      "description": "scheduled orders by the post's date ascending (soonest first) and drops paging. Omit for newest first."
    },
    "limit": {
      "type": "number",
      "description": "1-100, defaults to 20"
    },
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD or ISO 8601. Only posts dated at or after this. A scheduled post is dated by its scheduledAt, a sent post by when it was created."
    },
    "until": {
      "type": "string",
      "description": "YYYY-MM-DD or ISO 8601. Only posts dated at or before this (a date means the whole day)."
    },
    "before": {
      "type": "string",
      "description": "A publish id from a previous page's nextBefore. Returns the ones older than it."
    },
    "status": {
      "type": "string",
      "description": "Narrow to one or more statuses, comma separated: scheduled, draft, publishing, published, partial, failed or cancelled. Omit for everything."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Media id from media_presign"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Public https URL of the image or video file itself."
    },
    "altText": {
      "type": "string",
      "description": "What the image shows, for people using screen readers. Applied to carousel items."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "bytes",
    "contentType",
    "fileName"
  ],
  "properties": {
    "bytes": {
      "type": "number",
      "description": "File size in bytes"
    },
    "width": {
      "type": "number",
      "description": "Pixel width, if you know it"
    },
    "height": {
      "type": "number",
      "description": "Pixel height, if you know it"
    },
    "altText": {
      "type": "string",
      "description": "What the image shows, for people using screen readers. Write it whenever you can see the image. Applied to carousel items."
    },
    "fileName": {
      "type": "string"
    },
    "contentType": {
      "type": "string",
      "description": "image/jpeg or image/png or image/webp or image/gif or video/mp4 or video/quicktime or video/webm"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string",
      "description": "One line shown on the upload page, e.g. what you need them to upload."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "The token from media_upload_link."
    },
    "offset": {
      "type": "integer",
      "description": "Skip this many images before returning previews (default 0)."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "form": {
      "type": "string",
      "description": "Form preset id (default photo-story). GET /v1/naver/forms lists them."
    },
    "forms": {
      "anyOf": [
        {
          "enum": [
            "all"
          ],
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "\"all\" for every preset, or a list of preset ids. Returns layouts[] instead of one layout."
    },
    "content": {
      "type": "string",
      "description": "The markdown body you plan to publish."
    },
    "mediaIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The media ids you will attach. Photos not referenced in the body get placed."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "accountIds"
  ],
  "properties": {
    "wait": {
      "type": "boolean",
      "description": "Hold the response until the post is really out. Text waits up to 10 seconds, posts with media up to 90 seconds. If it is still going after that you get the usual publishing response and should poll get_post. Defaults to false. Ignored with scheduledAt or draft."
    },
    "draft": {
      "type": "boolean",
      "description": "true saves the post as a draft on uplika without sending anything. Use it when the person wants to review before it goes out. They finish it in the dashboard, or you call update_post and publish_now."
    },
    "batchId": {
      "type": "string",
      "description": "Optional tag (letters, digits, - or _) to group posts made together, for example the same text sent to two workspaces. Pass the same value on each call."
    },
    "content": {
      "type": "string",
      "description": "Post text"
    },
    "options": {
      "type": "object",
      "properties": {
        "tiktok": {
          "type": "object",
          "properties": {
            "title": {
              "type": "string",
              "maxLength": 90,
              "description": "Required for a photo post, up to 90 characters. A video post has no title field at all and passing one is rejected; a video's text comes from content."
            },
            "isAigc": {
              "type": "boolean",
              "description": "Declare that the content was generated by AI. Worth setting when you made the video or images."
            },
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content."
            },
            "postMode": {
              "enum": [
                "direct",
                "draft"
              ],
              "type": "string",
              "description": "direct (default) posts to the profile. draft sends it to the creator's TikTok inbox; they open the notification and finish it in the app, choosing the visibility themselves. While this app awaits the Content Posting audit this is the only way to get something out publicly: a direct post can only be SELF_ONLY, but on this path we send no visibility at all. The trade is that it is not on the profile until the person finishes it, so there is no link and no metrics in the meantime."
            },
            "disableDuet": {
              "type": "boolean",
              "description": "Turn duets off for this post. Video posts only."
            },
            "privacyLevel": {
              "type": "string",
              "description": "Required unless postMode is draft. One of the values that get_publish_options returns for this account, e.g. PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY. The list differs per account, so do not hard-code it."
            },
            "disableStitch": {
              "type": "boolean",
              "description": "Turn stitches off for this post. Video posts only."
            },
            "disableComment": {
              "type": "boolean",
              "description": "Turn comments off for this post. Cannot be set to false if the creator disabled comments account-wide."
            },
            "brandContentToggle": {
              "type": "boolean",
              "description": "Declare paid partnership content (\"Branded Content\"). TikTok does not allow branded content to be private, so this cannot be combined with privacyLevel SELF_ONLY."
            },
            "brandOrganicToggle": {
              "type": "boolean",
              "description": "Declare that the post promotes the creator's own brand (\"Your Brand\"). Leave it out rather than sending false: not declaring and declaring 'no' are different statements."
            },
            "videoCoverTimestampMs": {
              "type": "number",
              "minimum": 0,
              "description": "Which frame to use as the cover, in milliseconds into the video. TikTok does not accept a cover image file, only a timestamp."
            }
          },
          "description": "TikTok settings. privacyLevel is REQUIRED for a normal post and has no default on purpose: TikTok's rules say the person must choose visibility deliberately, so we ask for it instead of guessing. Call get_publish_options first to see which values this account may use right now, whether it can post at all, and its video length limit. TikTok has no text-only posts, cannot mix a video and photos, and has no API for deleting a post or reading comments. While this app is awaiting TikTok's Content Posting audit a direct post can only be SELF_ONLY and comes back with no link and no metrics; if the person wants it public in the meantime, use postMode draft instead."
        },
        "bluesky": {
          "type": "object",
          "properties": {
            "langs": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$",
                "description": "One BCP-47 code."
              },
              "maxItems": 3,
              "description": "The language of the text, 1-3 BCP-47 codes like [\"ko\"] or [\"en\", \"ko\"]. Feed generators filter on this, so without it the post never appears in language-scoped feeds. Bluesky has no post editing, so this cannot be fixed after publishing. Set it to the language the text is actually written in."
            },
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content."
            }
          },
          "description": "Bluesky settings. Optional, but langs is worth setting on every post."
        },
        "threads": {
          "type": "object",
          "properties": {
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content."
            },
            "topicTag": {
              "type": "string",
              "maxLength": 64,
              "description": "One topic to tag the post with, like a category. Threads takes exactly one and rejects periods and ampersands in it. On a thread it goes on the first piece only. Leave it out unless the person asked for a topic."
            }
          },
          "description": "Threads settings. Optional."
        },
        "youtube": {
          "type": "object",
          "required": [
            "title"
          ],
          "properties": {
            "tags": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "One search tag."
              },
              "description": "Search tags. 500 characters across all of them; a tag with a space costs two extra for the quotes YouTube adds."
            },
            "title": {
              "type": "string",
              "maxLength": 100,
              "description": "Video title, up to 100 characters. Required. Cannot contain < or >."
            },
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content."
            },
            "publishAt": {
              "type": "string",
              "description": "ISO 8601 time to make the video public. Only works with privacyStatus private, and only on a video that was never public. This is YouTube's own scheduling; for scheduling across channels use scheduledAt on the post."
            },
            "categoryId": {
              "type": "string",
              "description": "YouTube category id. Defaults to 22 (People & Blogs). Leave it out unless the person named a category."
            },
            "madeForKids": {
              "type": "boolean",
              "description": "Whether this video is directed at children. This is a legal declaration about someone else's channel. Leave it out unless the person tells you, and the channel's own default applies."
            },
            "privacyStatus": {
              "enum": [
                "public",
                "unlisted",
                "private"
              ],
              "type": "string",
              "description": "Defaults to private. We pass this through as you set it. If YouTube applies something else, the result carries a warning saying what it actually applied."
            },
            "thumbnailMediaId": {
              "type": "string",
              "description": "Media id of a JPEG or PNG up to 2MB to use as the thumbnail. Long-form only: YouTube does not take custom thumbnails on Shorts, and a vertical video of three minutes or less becomes a Short. The channel also has to be verified before YouTube accepts one."
            },
            "containsSyntheticMedia": {
              "type": "boolean",
              "description": "Set true when the video contains realistic altered or synthetic content, including AI generated footage of real-looking people, places or events."
            }
          },
          "description": "Required when a YouTube account is in accountIds. The post content becomes the video description."
        },
        "facebook": {
          "type": "object",
          "properties": {
            "link": {
              "type": "string",
              "description": "Makes a link post with a preview card. Cannot be combined with media."
            },
            "title": {
              "type": "string",
              "description": "Reel title, separate from the caption."
            },
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content."
            },
            "contentType": {
              "enum": [
                "feed",
                "story",
                "reel"
              ],
              "type": "string",
              "description": "What kind of post. Defaults to reel for a single video and feed otherwise. A Facebook story is rejected if you send any text: publish the story with no content, and put the words in a feed post instead. A story also takes exactly one image or video and no first comment."
            },
            "firstComment": {
              "type": "string",
              "description": "A comment we post right after publishing. Not on stories, and not on scheduled posts. If it fails the post still goes up, with a warning."
            },
            "scheduledPublishTime": {
              "type": "string",
              "description": "ISO 8601 time to publish a feed post later, 10 minutes to 28 days from now. Feed posts only, not reels or stories. Cannot be combined with firstComment (a scheduled post is not live yet, so nothing to comment on). This is Facebook's own scheduling; for scheduling across channels use scheduledAt on the post."
            }
          },
          "description": "Facebook Page settings. Optional: plain text publishes without it."
        },
        "telegram": {
          "type": "object",
          "properties": {
            "content": {
              "type": "string",
              "description": "Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to us
… [server-provided details truncated]

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "wait": {
      "type": "boolean",
      "description": "Hold the response until the post is really out, same as on publish."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "doc",
    "id",
    "version"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "doc": {
      "type": "object",
      "required": [
        "nodes",
        "start",
        "triggers",
        "v"
      ],
      "properties": {
        "v": {
          "type": "integer",
          "const": 1
        },
        "nodes": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "all": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "field",
                    "op"
                  ],
                  "properties": {
                    "op": {
                      "enum": [
                        "eq",
                        "ne",
                        "gt",
                        "lt",
                        "has",
                        "not_has",
                        "contains"
                      ],
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    },
                    "field": {
                      "enum": [
                        "tag",
                        "follows_us",
                        "we_follow",
                        "follower_count",
                        "verified",
                        "window_open",
                        "opted_in",
                        "last_interaction_hours",
                        "field",
                        "intent",
                        "sentiment",
                        "text"
                      ],
                      "type": "string"
                    },
                    "value": {}
                  }
                }
              },
              "else": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Id of the next node, or null to stop."
              },
              "flow": {
                "type": "string"
              },
              "mode": {
                "enum": [
                  "window",
                  "private_reply",
                  "public_reply"
                ],
                "type": "string",
                "description": "send: window = inside the 24-hour window, private_reply = one DM to a commenter, public_reply = comment under the post."
              },
              "next": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Id of the next node, or null to stop."
              },
              "then": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Id of the next node, or null to stop."
              },
              "type": {
                "enum": [
                  "send",
                  "condition",
                  "action",
                  "delay",
                  "random",
                  "goto",
                  "ai"
                ],
                "type": "string"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "type"
                  ],
                  "properties": {
                    "key": {
                      "type": "string"
                    },
                    "tag": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        "add_tag",
                        "remove_tag",
                        "set_field",
                        "clear_field",
                        "opt_in",
                        "opt_out",
                        "open_conversation",
                        "close_conversation",
                        "assign",
                        "hide_reply",
                        "approve_reply"
                      ],
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    },
                    "userId": {
                      "type": "string"
                    }
                  }
                }
              },
              "blocks": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "type"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        "text",
                        "image",
                        "video",
                        "audio",
                        "file",
                        "delay",
                        "card",
                        "gallery"
                      ],
                      "type": "string"
                    },
                    "cards": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "title": {
                      "type": "string"
                    },
                    "buttons": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "kind",
                          "title"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "kind": {
                            "enum": [
                              "postback",
                              "url"
                            ],
                            "type": "string"
                          },
                          "next": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Id of the next node, or null to stop."
                          },
                          "title": {
                            "type": "string",
                            "description": "At most 20 characters."
                          }
                        }
                      }
                    },
                    "mediaId": {
                      "type": "string"
                    },
                    "seconds": {
                      "type": "number"
                    },
                    "imageUrl": {
                      "type": "string"
                    },
                    "subtitle": {
                      "type": "string"
                    }
                  }
                }
              },
              "buttons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "kind",
                    "title"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string"
                    },
                    "kind": {
                      "enum": [
                        "postback",
                        "url"
                      ],
                      "type": "string"
                    },
                    "next": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Id of the next node, or null to stop."
                    },
                    "title": {
                      "type": "string",
                      "description": "At most 20 characters."
                    }
                  }
                },
                "maxItems": 3
              },
              "seconds": {
                "type": "number"
              },
              "branches": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "weight"
                  ],
                  "properties": {
                    "next": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Id of the next node, or null to stop."
                    },
                    "weight": {
                      "type": "number"
                    }
                  }
                }
              },
              "escalate": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Id of the next node, or null to stop."
              },
              "maxTurns": {
                "type": "integer"
              },
              "usePersona": {
                "type": "boolean"
              },
              "instruction": {
                "type": "string"
              },
              "quickReplies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "title"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "next": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Id of the next node, or null to stop."
                    },
                    "title": {
                      "type": "string"
                    }
                  }
                },
                "maxItems": 13
              }
            }
          }
        },
        "start": {
          "type": [
            "string",
            "null"
          ]
        },
        "layout": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              }
            }
          }
        },
        "template": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "params": {
              "type": "object"
            }
          }
        },
        "triggers": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "kind"
            ],
            "properties": {
              "at": {
                "type": "string"
              },
              "ref": {
                "type": "string"
              },
              "tag": {
                "type": "string"
              },
              "kind": {
                "enum": [
                  "comment",
                  "live_comment",
                  "message",
                  "story_reply",
                  "story_mention",
                  "referral",
              
… [server-provided details truncated]

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "The account id from list_accounts."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "secret": {
      "type": "boolean",
      "description": "Naver Blog only: post it as a secret comment that only the blog owner can read. Other channels refuse it."
    },
    "content": {
      "type": "string"
    },
    "replyTo": {
      "type": "string",
      "description": "Reply id from list_replies. Omit to reply to the post itself."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "properties": {
    "scope": {
      "description": "Omit to list candidates, \"all\" for every active channel, or an array of platform names, handles or account ids."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Conversation id from list_conversations."
    },
    "text": {
      "type": "string"
    },
    "draftId": {
      "type": "string",
      "description": "Message id of an AI draft to send instead of new text."
    },
    "mediaId": {
      "type": "string",
      "description": "Optional media id from media_presign."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A publish id (post_…), the post's own id on the channel, or a post link (the URL you would open in a browser to see it). Links work for posts written in the channel's own app too, as long as the account is connected here."
    },
    "draft": {
      "type": "boolean",
      "description": "true turns a scheduled post back into a draft."
    },
    "content": {
      "type": "string",
      "description": "New post text."
    },
    "options": {
      "type": "object",
      "description": "Per-channel settings, same shape as on publish. Replaces the whole object."
    },
    "mediaIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New media, in order. Replaces the current set."
    },
    "accountIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New target accounts, from select_channels. Replaces the current set."
    },
    "scheduledAt": {
      "type": [
        "string",
        "null"
      ],
      "description": "New send time (ISO 8601 with offset, 10 minutes to 365 days out), or null to keep the post as a draft instead."
    },
    "workspaceId": {
      "type": "string",
      "description": "Which workspace this is for. Only needed when the account has more than one — the error tells you the ids when it matters. Leave it out if it is already decided; do not ask the person again."
    }
  }
}