Save a concept (agent-authored)
flypost_save_conceptSave a concept whose WORDS you wrote yourself: carousel slides, or the title/angle brief for a single image or infographic. Lands at concept stage with no flypost_develop_concept pass (and no AI billing). Returns editor_url — the in-app editor for this concept. Single images: set image_substyle AND the matching image_copy (the exact words baked onto the image) — the render uses those verbatim; without them the image model invents the headline and can feature the wrong number. Infographics: same deal — set infographic_style AND the matching infographic_copy, which carries every figure and line the graphic shows. The prose angle does NOT reach the image model intact, so any number you leave only in the angle gets invented. Then follow the returned next_steps: by default flypost_design_visual designs it (a carousel deck, an infographic, or a stat or comparison Image post) in their brand; the template deck and AI image pipelines are for when the user asks for them. Pass content_bank_item_id to overwrite an existing item in place; omit it to create a new one. Ground the copy via flypost_get_writing_voice + flypost_search_source_docs first. The angle you pass is automatically filed into a per-agent Brain source package so your framing stays visible and checkable — pass agent_name so it is filed under your name.
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": {
"title": "<title>",
"target_format": "<target_format>"
},
"name": "flypost_save_concept"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| angle | No | The angle / narrative context (2-3 sentences). | |
| title | Yes | ||
| slides | No | Carousel only — the deck you wrote. Order: one hook (numbered-list headline + short subtitle), optional rehook, body slides (auto-numbered), optional recap, one cta last. Keep each slide ~22 words. | |
| sources | No | Sources the copy is grounded on (slide source_refs point at these ids). | |
| signature | No | Deck accent colours; defaults to the brand palette. | |
| agent_name | No | Your product name as the calling agent (e.g. 'Claude'). Names the per-agent Brain source package your material is filed into and the 'Idea by …' attribution shown in the post editor. Defaults to 'AI agent'. | |
| image_copy | No | single_image only — the EXACT words baked onto the image (required for single images). Fill ONLY the fields for the chosen image_substyle: striking_stat → stat (+ label); comparison → before + after (+ header); meme → setup + punchline; product_in_situ → annotation (+ label); ai_decide → picture + words. Keep every line SHORT (one line max; the ai_decide picture may run to two sentences) — it is rendered on the image, not a paragraph. The striking_stat hero line is a complete claim with the number embedded in it (never the bare figure), and its number must be YOUR conclusion, never a figure you are debunking. Without this the image model invents the headline (and can feature the wrong number). | |
| project_id | No | Project id; omit for the active project. | |
| target_format | Yes | ||
| authoring_note | No | One short sentence on what this is based on (e.g. the conversation or document it came from). Shown as attribution in the post editor. | |
| image_substyle | No | single_image only: striking_stat (one striking stat line IS the whole point) / comparison (two named sides) / product_in_situ (an AI-drawn product scene + callout; it redraws the screen, so for the user's real screenshot use flypost_design_visual with images) / meme (a joke) / ai_decide ("Let AI decide": a picture-led image, for an idea better shown than stated when none of the others fits). Pick the one the idea can actually deliver, then supply the matching image_copy. Defaults to striking_stat. | |
| format_archetype | No | Carousel template archetype; defaults to listicle. | |
| infographic_copy | No | infographic only — the EXACT body copy baked onto the image (required for infographics). Fill ONLY the array for the chosen infographic_style: stats → points; list → items; how_to → steps. Every value is rendered as given, so write finished copy and keep each line short. CRITICAL for stats: the render shows ONLY the figures you put in points[].value — anything you leave in the prose angle never reaches the image model, so a figure that is not here will be INVENTED by it. Pass every number the graphic should show, and no number you cannot source. | |
| infographic_style | No | infographic only: stats (figures by category) / list (numbered points) / how_to (ordered steps). Defaults to stats. Supply the matching infographic_copy. | |
| source_package_id | No | Optional notebook this concept is grounded on. | |
| content_bank_item_id | No | Update this existing item in place; omit to create a new concept. |