Skip to main content
POST
Import Json Async

Headers

authorization
string | null
X-Organization-ID
string | null

Cookies

stytch_session
string | null

Body

application/json

Request model for async JSON product import (file already in GCS).

gcs_url
string
required

GCS URL of the uploaded JSON file (gs://...)

enrich_product
boolean
default:true

Run AI enrichment

ignore_manual_edits
boolean
default:false

When True, do NOT preserve properties flagged properties_metadata.{key}.manual_edit — the incoming values win. Default False keeps the manual-edit protection. Intended for a deliberate authoritative resync where the source of truth is external; protect specific fields by omitting them from the payload instead.

merge_only_provided
boolean
default:false

When True, overlay ONLY the provided properties onto each existing product's latest version, preserving all other fields. Ignored when enrichment is requested.

scrape_brand_site
boolean
default:true

Scrape brand website during enrichment

search_lakehouse
boolean
default:true

Search product lakehouse for existing data

validate
boolean
default:false

Validate against ProductType

Response

Successful Response