Skip to main content

Bulk Generate & Apply Listing Content

POST 

/api/ai/listing-content/bulk

Queue a bulk AI content enrichment for many products on one sales channel. For each product the configured AI provider generates listing content, which is written to the product attributes that channel's templates read from — so the products become ready to list without generating each one individually. Returns 202 with a tracked job id; the job records a per-product summary (enriched / skipped / failed) as it runs.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Only content fields the channel binds to a product attribute are filled; a channel whose content comes from product columns or fixed values has nothing to enrich and returns 422. Enrich at most 500 products per call.

Body fields:

  • sales_channel_id (integer, required) — the target sales channel.
  • product_ids (integer[], required, 1–500) — the products to enrich.

Requires permission: products.update

Returns 422 when AI is turned off for the workspace (no API key for the active provider); an admin turns it on in the AI Assistant settings.

Request​

Responses​

Accepted

Response Headers
    Content-Type