Get in touch
Get in touch

Authentication

Access to the API is granted via an API key and, for private Datasets, an optional set of OAuth credentials. These are unique to each application and bound to the account that created them. 

Generating application credentials

To create application credentials, navigate to the Applications screen of the Data Graphs app. Note this is only accessible by users with one of the roles OwnerAdministrator or Developer.

Click Create New Application to create a new set of API credentials. You must name your application and choose whether it has read access or read/write access to your data.

Generate an OAuth 2.0 token

Once you have your application credentials, you can use them to generate the access token you'll need for calls to private Datasets.

Use the clientId and clientSecret in the body of a request to POST /oauth/token as follows:

	{
  	  "clientId": "{clientId}", 
  	  "clientSecret": "{clientSecret}"
	}

The response will be in the form:

	{ 
  	  "access_token": "eyJhbGciOiJSUzI1N.....", 
  	  "expires_in": 86400, "token_type": "Bearer"
	}