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.
products:writeGrant 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
- 202
- 401
- 403
- 422
- 429
Accepted
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.