{"success":true,"version":1,"docs":"\/developers","rest":{"GET    \/api\/flows\/{id}":"Read full content layer + screen previews","PATCH  \/api\/flows\/{id}":"Set theme or title","GET    \/api\/flows\/{id}\/preview\/{n}":"Preview image URL for screen n (?redirect=1 \u2192 302)","GET    \/api\/flows\/{id}\/screens\/{n}":"Read single screen + its preview","POST   \/api\/flows\/{id}\/screens":"Insert a screen ({position?, screenContent})","DELETE \/api\/flows\/{id}\/screens\/{n}":"Delete screen n","POST   \/api\/flows\/{id}\/screens\/{n}\/blocks":"Insert a block ({blockContent})","PATCH  \/api\/flows\/{id}\/screens\/{n}\/blocks\/{bid}":"Edit a block (body.type chooses kind)","DELETE \/api\/flows\/{id}\/screens\/{n}\/blocks\/{bid}":"Delete a block"},"flow_patch":{"set-theme":{"theme":"modern-dark"},"set-title":{"title":"My new title"}},"block_kinds":{"text":{"desc":"Plain-text title\/subtitle\/body block. PATCH sets the text.","patch_example":{"type":"text","text":"Hello world"},"create_example":{"blockContent":{"type":"body","text":"Hello world"}}},"bullet-list":{"desc":"Bulleted list. PATCH replaces all items.","patch_example":{"type":"bullet-list","items":["First","Second","Third"]},"create_example":{"blockContent":{"type":"bullet-list","items":["a","b"]}}},"stat":{"desc":"Big-number stat. data.value, data.label, data.context, data.trend.","patch_example":{"type":"stat","data":{"value":"85%","label":"Growth","context":"YoY","trend":"up"}}},"chart":{"desc":"Bar\/pie\/donut chart.","patch_example":{"type":"chart","data":{"chartType":"bar","title":"Revenue by quarter","data":[{"label":"Q1","value":100},{"label":"Q2","value":140}]}}},"timeline":{"desc":"Ordered timeline of events.","patch_example":{"type":"timeline","data":{"entries":[{"date":"2024","title":"Founded","description":"..."},{"date":"2025","title":"Series A","description":"..."}]}}},"cta-button":{"desc":"Call-to-action button.","patch_example":{"type":"cta-button","text":"Book a demo","url":"https:\/\/example.com"}},"image":{"desc":"Image block. URL must be on a trusted CDN or have a known image extension.","patch_example":{"type":"image","imageUrl":"https:\/\/cdn.flow2.co\/generated_images\/abc.png"}},"video":{"desc":"Video block.","patch_example":{"type":"video","videoUrl":"https:\/\/example.com\/video.mp4","poster":"https:\/\/example.com\/poster.jpg"}},"team":{"desc":"Team grid.","patch_example":{"type":"team","members":[{"name":"Alice","role":"CEO","imageUrl":null},{"name":"Bob","role":"CTO","imageUrl":null}]}},"comparison-table":{"desc":"Side-by-side comparison.","patch_example":{"type":"comparison-table","columns":["Us","Them"],"rows":[{"feature":"Speed","values":["Fast","Slow"]}]}},"comparison-slider":{"desc":"Before\/after image slider.","patch_example":{"type":"comparison-slider","beforeSlide":{"imageUrl":"https:\/\/..."},"afterSlide":{"imageUrl":"https:\/\/..."}}},"set-background":{"desc":"Set a screen image background. Targets screen, not block. Patch the screen, not a block.","patch_example":{"type":"set-background","imageUrl":"https:\/\/..."}},"set-video-background":{"desc":"Set a screen video background.","patch_example":{"type":"set-video-background","videoUrl":"https:\/\/...","poster":"https:\/\/..."}},"remove-background":{"desc":"Remove a screen background.","patch_example":{"type":"remove-background"}}},"screen_verbs":{"add-screen":"POST \/api\/flows\/{id}\/screens with body {position, screenContent}","delete-screen":"DELETE \/api\/flows\/{id}\/screens\/{n}","reorder-screen":"Not yet exposed via REST. Available via raw updates[] on \/ai\/update-flow."},"auth":{"header":"Authorization: Bearer fvapi_*","mint_token":"POST \/api\/generate-token (logged-in PRO\/Premium user)","agent_tokens_can_edit":false,"note":"Agent tokens (from \/api\/signup) can create flows but cannot edit. Editing requires a user token."}}