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.

Administrator Basic Authentication

post

Starts a session given a username/password and puts it into a cookie.

Authorizations

Lenses_HQ_API_bearerAuthLenses_HQ_API_cookieAuth

AuthorizationstringRequired

The bearer token can be obtained by creating a ServiceAccount.

Body

application/json

Bundles a username/password for authentication purposes.

usernamestringRequired

passwordstringRequired

Responses

204

Happy response. A set-cookie header will be present.

post

/v1/login

HTTPcURLJavaScriptPython

POST /v1/login HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "username": "text",
  "password": "text"
}

204

Happy response. A set-cookie header will be present.

No content

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'