Upload Property Overrides Csv

curl --request POST \
  --url https://api.merchantops.ai/api/property-definitions/overrides/upload-csv \
  --header 'Content-Type: application/json' \
  --data '
{
  "csv_content": "<string>"
}
'

{
  "created": 123,
  "failed": 123,
  "total": 123,
  "updated": 123,
  "cleaned": 0,
  "errors": [
    {
      "error": "<string>",
      "row": 123,
      "key": "<string>"
    }
  ],
  "skipped": 0
}

Property Definitions

Upload Property Overrides Csv

Upload per-ProductType OR per-Category enrichment overrides from CSV.

Required columns: product_type_key, property_key. Optional columns: prompt_name_override, ai_matching_guidance_override, enrichment_config_override_json.

Target syntax in product_type_key:

<key> → per-ProductType override (writes onto the ProductType’s PropertyReference). Existing behavior, unchanged.
category:<key> → per-Category override (writes to the category_enrichment_overrides collection). Resolves at enrichment time when the ProductType has category=<key> set.

The category form lets a customer hold one prompt per category (e.g. Footwear / Apparel / Accessories) instead of duplicating the same override across every ProductType in that category.

Behavior:

Idempotent upsert: each row replaces any existing override at the same target.
Empty cells clear the corresponding field.
Rows whose ProductType or Property don’t exist are recorded as skipped, not failed.
Requires product_type:write (covers both targets).

POST

api

property-definitions

overrides

upload-csv

Upload Property Overrides Csv

curl --request POST \
  --url https://api.merchantops.ai/api/property-definitions/overrides/upload-csv \
  --header 'Content-Type: application/json' \
  --data '
{
  "csv_content": "<string>"
}
'

{
  "created": 123,
  "failed": 123,
  "total": 123,
  "updated": 123,
  "cleaned": 0,
  "errors": [
    {
      "error": "<string>",
      "row": 123,
      "key": "<string>"
    }
  ],
  "skipped": 0
}

Headers

authorization

string | null

X-Organization-ID

string | null

Cookies

stytch_session

string | null

Body

application/json

Request model for CSV upload.

csv_content

string

required

CSV content as string

Response

Successful Response

Response model for batch CSV upload operations.

created

integer

required

Number of new records created

failed

integer

required

Number of rows that failed

total

integer

required

Total rows processed

updated

integer

required

Number of existing records updated

cleaned

integer

default:0

Number of existing null values cleaned up from the database

errors

CsvBatchError · object[]

List of errors

Show child attributes

skipped

integer

default:0

Number of rows skipped due to null/empty values

Export Property Overrides Csv Search Property Definitions

⌘I