Authentication

To start making API requests, you need an access token for the account in question.

Getting an access token for your own account

• Log in to Knowlex, click the top right-hand menu (your avatar), then click developers.
• Create a new client app if none exists
• Generate a temporary access key using the interface

Getting an access token for a 3rd party account via Oauth2

• Log in to Knowlex, click the top right-hand menu (your avatar), then click developers.
• Create a new client app if none exists
• Enter the oauth callback url for your app
• Redirect your users to https://app.knowlex.be/authorize?client_id={client_id}&state=xyz
• use https://api.knowlex.be/api/token to exchange the authorization code for an access token and a refresh token. More information about this API call here: https://apidocs.knowlex.be/v1.0/reference
• Your app can now be used to connect to your own account. To be able to connect to 3rd party account, your app needs to be verified. Contact us via chat or [email protected].

Using access tokens in a request

To authorize any API request, add the 'Authorization' header field. It should contain the text 'Bearer <access_token>'

Refresh access tokens using a refresh key

The /api/token endpoint can also be used to gain a new access key using your refresh key. Refresh tokens are long-lived and can be reused. More information about this API call here: https://apidocs.knowlex.be/v1.0/reference