Skip to main content


To use the API, you need to be authenticated. Two authentication methods are available:

Basic Authentication​

When browsing the API on unless you enter credentials a popup will ask for your credentials for basic authentication.

JSON Web Token​

To generate a token you need to authenticate with your username and password to /v1/jwt-auth/ with a POST request :

curl -X POST -H "Content-Type: application/json" -d '{"username": "","password":"WinterIsComing"}'

The API returns a JSON with a token property that you can use to make authenticated API calls. Example:

curl  -H 'Accept: application/json' -H "Authorization: JWT <YOUR_TOKEN>"

The token is valid for a period of 5 minutes. To refresh the token you need to make POST request to /v1/jwt-refresh/ with the current token:

curl -X POST -H "Content-Type: application/json" -d '{"refresh": "<YOUR_REFRESH_TOKEN>"}'

You can refresh multiple times the token for a period of seven days after the authentication. After this delay, you will need to re-authenticate.