Start import

/data/v2/projects/{projectToken}/imports/{import_id}/start

Trigger the run of an existing import.

The following types of imports can be triggered: URL, Filestorage (GCS, SFTP), Database, Bloomreach Engagement.

If it is a URL or a Filestorage (GCS, SFTP), it is possible to override its original path/URL. When overridden, it does not modify the import definition, the path is overridden just for this run of the import.

Please note that the import must be running (repeated). One-time imports are not supported. The import must also be at least in a state of draft to be able to trigger. This means you need to already have SFTP integration configured and working.

Definition

Authorization

In this API call you must use the following authorization access and permissions:

Available access typePermissions needed
Private accessImports > Allow trigger imports

Read more about:

Path parameters

ParameterTypeDescriptionRequired
projectTokenstringThe ID of your project.Required
import_idstringThe ID of an existing import in your project.Required

Body Parameters

ParameterTypeDescriptionRequired
pathstringURL, GCS, or SFTP path to override. Note that this does not modify the import definition, the path is overridden just for this run of the import.No
test_connectionbooleanAllows you to skip the import source connection checking and thus avoid timeouts. Note that imports can fail to execute later because source was not checked. Default = true.No

Header

ParameterTypeDescriptionRequired
authorizationstringUsed for authentication. Read more in the Authentication section.Required
content-typestringapplication/json

Note that if you are sending this request without a body, the header must not contain content-type: application/json. Including it will result in Error 400
Required if body is not empty.

Limitations

  • It is not possible to trigger Copy & Paste and Upload imports from this route.
  • The import must be running (repeated). One-time imports are not supported.
Language
Click Try It! to start a request and see the response here!