Submit Proposals

POST /api/enrichment/products/submissions · Scope: catalog:submit

Submit a batch of enrichment proposals. Each item becomes a pending revision for reviewer acceptance. See the guide.

Request body

string

Your own correlation/idempotency handle for the batch. Optional but recommended.

object[]

required

1–1000 submission items.

Show item

string

required

Identity key matching the proposal to a product.

integer

Certainty 0–100. Drives reviewer triage. Optional.

string

Proposed name. Enrichable.

string

Proposed slug. Enrichable.

string

Proposed description. Enrichable.

object[]

Proposed attributes (attribute, detail, option). Enrichable.

string[]

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.

string

Echo of the item’s identity, for correlation.

number | null

Matched product id, or null when unmatched.

number | null

Created revision id when status is CREATED.

string

One of:

CREATED — pending revision created.
UNMATCHED — no product matched the identity (or ambiguous).
REJECTED_FIELDS — no whitelisted, non-empty enrichable fields to propose.

string[]

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`

Overview

Catalog

Submissions

Request body

Response `200`

Errors

​Request body

​Response 200

​Errors

Request body

Response `200`

Errors