Changelog
Brand fonts — November 2026
A brand can hold a heading and a body font file, and its ads are set in them. See Analyze a brand.
attachBrandFont,removeBrandFontandimportGoogleBrandFontset, clear and import a brand's font file for theheadingorbodyrole, and needbrands:write. A Google import is limited to 10 a minute and 100 a day; when Google Fonts cannot be reached it answers503brands.google_fonts_unavailable.startMediaUploadtakeslicenceConfirmed, required for a font (a TTF or OTF file of up to 10 MB), which says its licence allows use in ads. Ask your customer before you set it. A font is kept for the brand and never listed in the media library.getBrandandlistBrandsanswerfontFileswith the files each role has; editing a brand or approving a new analysis leaves them as they are.- An ad's
compositionlists a stored font asfonts[].asset, a file of{ key, mediaType }thatad-edittakes back with the rest of the composition, like its pictures. Where a font lacks a character the text needs, the text is set in a neutral font and the edit's warnings name it asfont.
Runs on products — November 2026
An Addon can run on an imported product without an uploaded photo, and a succeeded run's results belong to the product. See Run Addons on products.
- An Addon input of type
producttakes{ productId, variant?, image? }; left out, the photo input itfillsgets the product's shop image. A shop image that is not loaded answers409orchestrator.product_image_not_ready. getProductnames therunof each asset a run linked, andlistProductscounts them ingeneratedImages.
Brands — November 2026
API keys can analyze a shop's brand, approve it and manage the account's brands. See Analyze a brand.
startBrandAnalysisandapproveBrandAnalysisneed the new permissionbrands:write, as doupdateBrand,setDefaultBrandanddeleteBrand. A key may start 10 analyses an hour and 30 a day. An analysis costs no credits.getBrandAnalysis,listBrandsandgetBrandneed the new permissionbrands:read.- An Addon input of type
brandtakes a brand'sid, ornullfor no brand. Left out, it takes the brand saved in the Addon's settings, otherwise the account's default brand.
Existing keys get brands:read and brands:write only when you add them.
Products — November 2026
API keys can import a shop's products into catalogs. See Import products.
createProductImport,readProductImportandstartProductImportimport a Shopify, Shopware or WooCommerce export, and needproducts:write, as do creating catalogs and sending products in batches.importProductFileFromUrlimports an export from a public https URL instead of an upload.- Listing catalogs and products and following imports need
products:read.
Redo — November 2026
API keys can make finished results again with a note:
redoOrchestratorRunneedsruns:create, and every redo sendsmaxCreditsand anidempotencyKey, as a start does. See Start runs.redoOrchestratorBatchandsetOrchestratorBatchItemVersionneedruns:manage. See Run batches.
Batches — October 2026
API keys can run an Addon on up to 50 items at once. See Run batches.
startOrchestratorBatchneedsruns:create, and every start sendsmaxCreditsand anidempotencyKey.getOrchestratorBatch,streamOrchestratorBatchandlistOrchestratorBatchesneedruns:read.cancelOrchestratorBatchandretryOrchestratorBatchneed the new permissionruns:manage.
When the key that started a batch is revoked, expires or loses runs:create, the batch starts
no more items. Existing keys get runs:manage only when you add it.
Run starts — October 2026
API keys can start runs and list the account's runs:
startOrchestratorRunneeds the new permissionruns:create, and every start sendsmaxCreditsand anidempotencyKey. See Start runs.listOrchestratorRunslists the account's runs and needsruns:read.
Existing keys get runs:create only when you add it.
v1 preview — October 2026
The first public API preview provides seven operations:
- List the account's available Addons.
- Start and complete a media upload.
- List the media library and read an asset.
- Read a known run's state or follow it as Server-Sent Events.
Calls use account API keys with explicit permissions. Run starts, the list of running runs, identity management and billing are outside this public API. Use the web app or a connected AI assistant to start runs.
This documentation update adds complete upload examples, run failure and stream handling, field descriptions, and guides for the refreshed web app. It does not add API operations or change their validation.
See Versioning and changes for the preview's compatibility policy and the API reference for the current contract.