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.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
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.
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 — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
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.