Preview a catalog mapping
Reads a CSV or public Google Sheet and proposes which column means what, plus location aliases, for you to confirm before importing. Nothing is saved.
Scopes: knowledge:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Body
Response
Successful Response
The proposed column mapping, value meanings and location aliases (fields as catalog_import.propose).
columns (listing field → column index) and value_maps.
The sheet's header row.
How many columns.
Each mapped categorical column's distinct values.
The meanings each categorical field accepts.
Locations found, each with proposed aliases.
The first rows, as read.
Data rows in the sheet.
How many rows read as available.