Skip to main content

ProductEnrichmentSuggestion

AI-generated suggestions for a product. Suggestion-only: nothing is written to the catalog until the user approves and saves through the normal product update path.

type ProductEnrichmentSuggestion {
attributes: [EnrichmentAttribute!]!
balanceDisplay: String
balanceDollars: String
brand: EnrichmentBrandSuggestion
category: EnrichmentCategorySuggestion
costDisplay: String
creditsUsed: Float!
description: String
dimensions: EnrichmentDimensions
imageCandidates: [EnrichmentImageCandidate!]!
notes: String
tags: [String!]!
unit: EnrichmentUnitSuggestion
}

Fields​

ProductEnrichmentSuggestion.attributes ● [EnrichmentAttribute!]! non-null object​

Web-verified spec attributes for the default variant (may be empty)

ProductEnrichmentSuggestion.balanceDisplay ● String scalar​

Remaining balance, preformatted e.g. "USD 9.84"

ProductEnrichmentSuggestion.balanceDollars ● String scalar​

Remaining AI credit balance, formatted dollars

ProductEnrichmentSuggestion.brand ● EnrichmentBrandSuggestion object​

The suggested brand.

ProductEnrichmentSuggestion.category ● EnrichmentCategorySuggestion object​

Best-matching existing category, or null if none fit

ProductEnrichmentSuggestion.costDisplay ● String scalar​

Cost of this enrichment, preformatted e.g. "USD 0.08"

ProductEnrichmentSuggestion.creditsUsed ● Float! non-null scalar​

AI credits (cents) consumed by this enrichment

ProductEnrichmentSuggestion.description ● String scalar​

Customer-friendly description (plain text)

ProductEnrichmentSuggestion.dimensions ● EnrichmentDimensions object​

Web-verified dimensions/weight, or null when none could be confirmed

ProductEnrichmentSuggestion.imageCandidates ● [EnrichmentImageCandidate!]! non-null object​

Validated public image candidates (may be empty when none were found)

ProductEnrichmentSuggestion.notes ● String scalar​

Human-readable notes, e.g. "No public image found"

ProductEnrichmentSuggestion.tags ● [String!]! non-null scalar​

Inferred B2B search/discovery tags (may be inferred, not web-grounded)

ProductEnrichmentSuggestion.unit ● EnrichmentUnitSuggestion object​

Best-matching existing base unit of measure, or null if none fit

Returned By​

enrichProduct mutation

Member Of​

EnrichmentJob object