Plan a post or carousel
plan_contentPlan a piece of content end to end: caption plus, for each slide, its idea and a detailed art-directed image prompt with a shared visual style. Written in this brand's voice — as the company, or as the person or character it speaks as. This is the right first step for a carousel: plan it, then feed each imagePrompt to generate_image, then create_post with the caption and the resulting URLs. Costs 35 AI credits per plan (the images are charged separately by generate_image); nothing is charged if it fails. For a week or a month of content use plan_campaign (to go through the plan with the user) or run_autopilot (to create it all as drafts). SPENDS AI CREDITS ONLY WITH confirm: true. Call it first without confirm: nothing runs and nothing is charged, you get the quote (what it will do and the credits). Tell the user, in your own words, exactly that — including the options you chose, so they can change them — and wait for a clear yes before calling again with the same arguments and confirm: true. One yes covers the plan they approved (e.g. every line of an approved voice-over with the chosen voice); anything new or different needs a new yes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Content format. Defaults to post. | |
| topic | No | Brief or topic. | |
| confirm | No | true ONLY after the user said yes to the quote (what it does and the credits). Without it nothing runs and nothing is charged. | |
| language | No | ||
| platform | Yes | Target network. | |
| keywordCta | No | Let the plan close with a keyword CTA ("comment WORD and I'll send it"). It may only offer something the brand actually has on file — see `deliverables` in get_brand_profile. With nothing on file, no CTA is produced. Off by default. | |
| slideCount | No | Number of images to plan (1 for a single post, 3-5 for a carousel). | |
| workspaceId | No | Workspace to work on (an id from list_workspaces). Not needed when this connection is tied to one workspace, or when you pass an account: the account's workspace is used. | |
| idempotencyKey | No | Optional. A unique id for this action (16-128 chars: letters, digits, _ : . -). If you are unsure whether a call went through (timeout, network error), repeat it with the SAME idempotencyKey and the same arguments: you get the original result and nothing is done twice. |