Iterate a Slide

POST/v1/iterate

Improve a previously generated slide based on feedback. Loads the previous code, applies your changes, and produces an updated .pptx. Returns a new job_id for polling.

Parameters

Name	Type	Required	Description
job_id	string	required	The job_id of the previous generation to iterate on.
feedback	string	optional	Improvement instructions. E.g., "Make headers larger, add a 5th column". Empty string triggers auto-iterate only.
mode	string	optional	Ignored — always pro quality ($0.10). Kept for backward compat.
auto_iterations	integer	optional	Number of visual QA rounds (0-3). Default: 0.
theme_id	string	optional	Override the theme for iteration.
theme	object	optional	Inline theme JSON override.

Response

202

{
  "job_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "queued",
  "name": "Build vs Buy Matrix (iterated)"
}

Examples

curl -X POST https://api.slideforge.dev/v1/iterate \
  -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "feedback": "Make the headers larger and change the accent color to blue"
  }'

Tips for effective feedback

Be specific and code-level: "increase font_size to 13pt" works better than "make text bigger"
Reference specific elements: "move the chart title 0.5 inches to the right"
You can chain iterations: iterate on the result of a previous iteration
Leave feedback empty to trigger auto-iterate only (visual QA without human direction)