Skip to main content
Skip table of contents

Data Source - Upload new File

The Data Source endpoint allows you to upload a new file as data source (type file) by POST request via the API. This can be useful, for example, if you want to regularly update your data source with an updated data file in an automated way.

The general format of the API endpoints is:


Variable Parameters:

Base URL

Depending on your data residency settings, you may need to look up {YOURBASEURL} to create the endpoint URL. You’ll find the BaseURL in the Settings tab above the API secret.

Data Source ID

To update an existing data source via API, you need the {DATASOURCEID}of the target data source that is to be replaced by the new file. You will find this ID at the very top of the Data Source Configuration screen (Data Source tab).

Limitations: (might be subject to change)

  • a maximum of 1 request per minute

  • a maximum of 100 requests per 24 hours

  • will not invalidate already cached versions. This can be worked around by decreasing the cache minutes value.


Example curl request:

curl -X POST \
  -u 'username:password' \
  --form 'file=@/path/to/file/datasource_data.json'

Example Postman:


Method POST with generated URL:


Basic Auth with username & password:


The type of the parameter has to be set to File.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.