POST /api/enrichment/products/submissions · Scope: catalog:submit
Request body
Your own correlation/idempotency handle for the batch. Optional but recommended.
1–1000 submission items.
Identity key matching the proposal to a product.
Certainty 0–100. Drives reviewer triage. Optional.
Proposed name. Enrichable.
Proposed slug. Enrichable.
Proposed description. Enrichable.
Proposed attributes (attribute, detail, option). Enrichable.
Proposed document references. Enrichable.
{
"externalSubmissionId": "batch-2026-06-22-001",
"items": [
{
"sku": "ABC-123",
"confidence": 92,
"name": "Acme 18V Cordless Impact Driver",
"description": "A compact 18V brushless impact driver...",
"attributes": [
{ "attribute": "Voltage", "detail": "18", "option": { "optionId": 880, "unit": "V", "priority": 1, "dataType": "NUMBER", "showOnWebsite": true } }
]
}
]
}
Response 200
One result per item, in submission order.
Echo of the item’s identity, for correlation.
Matched product id, or null when unmatched.
Created revision id when status is CREATED.
One of:
CREATED — pending revision created.UNMATCHED — no product matched the identity (or ambiguous).REJECTED_FIELDS — no whitelisted, non-empty enrichable fields to propose.
Submitted fields dropped as non-enrichable or empty.
[
{ "sku": "ABC-123", "productId": 90210, "revisionId": 55123, "status": "CREATED", "ignoredFields": [] },
{ "sku": "NOPE-1", "productId": null, "revisionId": null, "status": "UNMATCHED", "ignoredFields": [] }
]
Errors
| Status | When |
|---|
400 | items empty or missing (“Submission must contain at least one item”) |
400 | More than 1000 items (“Submission exceeds the maximum of 1000 items”) |
401 | Missing or invalid API key |
403 | Key lacks catalog:submit |
