The preview, row by row
The parsed preview, row by row: what each row would create or update, the image it resolved, and the validation errors that would stop it.
/v1/clients/{clientId}/imports/{importId}/rowsThe parsed preview, row by row: what each row would create or update, the image it resolved, and the validation errors that would stop it. Read this before committing. Filter by action and page with after and limit. Needs authority over the client — membership of its organization, an API key bound to this client, or tenant staff holding clients:manage; anything else is refused not_client_member or insufficient_scope (403), and an unknown client client_not_found (404). An unknown import gives import_not_found (404).
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Path Parameters
uuiduuidQuery Parameters
Value in
- "create"
- "update"
- "error"
Last seen row_no from the previous page
0 <= value1 <= value <= 200100Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/rows"[ { "row_no": 0, "action": "create", "sku": "string", "product_handle": "string", "title": "string", "payload": {}, "errors": [ "string" ], "image_url": "string", "applied": true }]One import and its counts
One import with its current status and counts — poll this after starting or committing an import, both of which finish in the background.
Apply a ready import in the background
Applies a previewed import in the background and answers 202 with the import moved to committing; poll the import to see it finish.