Validate Import (GraphQL)
Runs validation over the uploaded file without importing any data. This is the second step of the import lifecycle — run it after the import is created (over REST), before start.
Operation
| Operation | Type | Purpose |
|---|---|---|
validateAdminSettingsDataTransferImportValidate | Mutation | Validate the uploaded file |
Quirks
- The input takes the import's
importIdand anid(the validate IRI) — API Platform requires theidfield on every non-create mutation. - The response carries an
isValidflag. WhenisValidisfalse, readerrorsCount/invalidRowsCount, or download the error report over REST to see which rows failed. - Select
_idfor the numeric import id; the payloadidIRI does not resolve on mutation results.
Prerequisites
The example uses an illustrative import. Replace it with an import that exists in your store — use the adminSettingsDataTransferImports query to discover valid ids.
Permission: settings.data_transfer.imports.edit. All operations require an admin Bearer token — see Authentication.

