API Authentication

Find how to authenticate with Lenses APIs.

Administrator Basic Authentication

You can use HTTP Basic Authentication if you are an Administrator with a username and password (non-SSO).

To check if you are an Administrator, go to My profile > Organisation settings > Administrators.

Example

Get your user details via API:

curl https://lenses.example.com/api/v1/users/me -u my-admin-user:my-admin-password

Service Accounts

Use a Bearer Token to authenticate service accounts. Set the token in the HTTP header request.

Example

Get the list of environments via API:

curl https://lenses.example.com/api/v1/environments \
  -H 'Authorization: Bearer MY_SERVICE_ACCOUNT_KEY'