Preview a post (dry run)
preview_postChecks a post exactly as publishing would (accounts, caption and title limits per network, video length, schedule, TikTok audience) without sending or spending anything. caption is the text everywhere; overrides sets a different caption or title per network (e.g. {"youtube": {"title": "…"}, "tiktok": {"caption": "…"}}). For a TikTok account, tiktok.privacy_level is required: ask the user who can view it (never choose for them); an issue lists the allowed values when it is missing or not allowed. Always call this first and show the user the result; then publish_post with the same arguments.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video_id": "<video_id>",
"profile_id": "<profile_id>",
"account_ids": "<account_ids>",
"caption": "<caption>",
"mode": "<mode>"
},
"name": "preview_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | 'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot) | |
| title | No | Title for titled networks (YouTube); required when one is targeted | |
| No | Required when a Reddit account is targeted | ||
| tiktok | No | TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post. | |
| caption | Yes | Post text on every network (on YouTube: the description) | |
| timezone | No | IANA zone, e.g. Europe/Madrid (default: the server default) | |
| video_id | Yes | A ready video (list_videos / get_video status "ready") | |
| overrides | No | Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title. | |
| profile_id | Yes | The profile to post from (list_profiles) | |
| account_ids | Yes | Accounts of that profile to post to (list_profiles, postable: true) | |
| ai_generated | No | Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos) | |
| scheduled_at | No | Local time YYYY-MM-DDTHH:mm in `timezone` | |
| first_comment | No | Posted as the first comment where the network supports it | |
| youtube_privacy | No | YouTube visibility (default public) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| issues | Yes | ||
| dry_run | Yes | ||
| posts_needed | Yes |