Change a promo
update_promoChanges a promo by name: its lines (your words, a rewrite of one part with a note, or both in one change for different parts), the recipe, the feature's name, old screens (or not_old), screens wrongly taken for store images (not_marketing), taps made from two screenshots (pairs), store links, its notes (what it should say; lines the writer wrote are written again for them), new material (gather: box the cards on new screens and take a ready recording's frames, at the gather's prices), the screen in a scene, more app pages, the recipe, the bed, voice on or off, SFX on or off, the sizes. Timing, camera and motion are fixed. One round at a time: while the promo is working (gathering, or its draft or finals rendering) a change is refused; get_promo until it settles. Re-renders the 9:16 draft, paying only for the scenes that changed (3 credits per started 2 s) and 10 to put it together, plus any material the round buys (draft_916.material); estimate_only gives that price first. Returns the promo as get_promo does.
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": {
"promo_id": "<promo_id>"
},
"name": "update_promo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | No | Your own words for some parts; the rest stay | |
| notes | No | What the promo should say; lines the writer wrote are written again for it | |
| pairs | No | Up to 3 taps or clicks, each from two of the person's screenshots of the same screen (a phone app's tap scene, or a click on a web app): 2 credits each when made, nothing if the control isn't found | |
| sizes | No | The finals' sizes, for render_promo | |
| slots | No | The screen or cards in a scene, by slot (list_recipes names each recipe's slots) | |
| sound | No | Music, sound effects and voice | |
| gather | No | Also box new screens' cards and take a ready recording's frames (priced) | |
| lineup | No | One of the recipe's line-ups (list_recipes lists each with what it requires). Left out, the first the material meets; when none is met, the promo says what to send. A Quick line-up (list_recipes marks it) is used only when named, and sets its recipe; the promo stays Quick until a full line-up is named or null is passed, which goes back to the first full line-up the material meets | |
| recipe | No | The recipe: saas (a web app), mobile (a phone app), feature-launch (a new feature of a product) or ecom (a product in an online shop). Left out, the tool picks from what it is given and says which | |
| render | No | Re-render the 9:16 draft (default true; only the changed scenes are paid for) | |
| stores | No | A phone app's store pages: the end card shows each store's badge | |
| feature | No | The new feature's name, as the product calls it (feature launch) | |
| not_old | No | Asset ids of screens marked old by mistake: they become current screens again | |
| product | No | The product as the person gives it: for marketplaces, or a shop capture can't read. Shown as given, marked as theirs. On a promo that has one, the fields left out are kept, even when the name changes: for another product, give each field (null for none) | |
| rewrite | No | Have the writer rewrite one part, with a note; every other part stays. It can go with lines for other parts in the same change | |
| promo_id | Yes | The promo's id | |
| app_pages | No | More public pages to capture that show the product itself working (a public demo, tool or dashboard page), never the home page, product marketing or pricing (those go in site_pages, for a Quick promo) | |
| site_pages | No | Quick promos only: up to 3 public pages of the person's own site to make it from, 2 credits a page. Left out, the address itself. Home, product and pricing pages belong here, never in app_pages | |
| old_screens | No | Screenshots of the product from before the feature, the same kind of screen as the new ones (feature launch); they are only ever shown as the before | |
| product_page | No | The product's own page in the shop (ecom), e.g. https://shop.example/products/tote; captured with its photos, price and rating at 2 credits. null takes it off the promo | |
| wait_seconds | No | ||
| estimate_only | No | Price the change and spend nothing | |
| not_marketing | No | Asset ids of screens taken for a store's marketing images by mistake: they are used as app screens again | |
| other_products | No | Up to 3 other product pages from the same shop, for the grid (ecom); 2 credits each | |
| remove_app_pages | No | App pages to drop from the promo by their address, e.g. a page that couldn't be captured or isn't the product itself; the scenes that picked them pick again |