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:

{YOURBASEURL}/api/custom/DataSource/ChangeFile/{DATASOURCEID}
CODE

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 \
  'https://external-data-for-jira.codefortynine.com/api/custom/DataSource/ChangeFile/{DATASOURCEID}' \
  -u 'username:password' \
  --form 'file=@/path/to/file/datasource_data.json'
CODE

Example Postman:

URL

Method POST with generated URL:

Authorization

Basic Auth with username & password:

Body

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