latestOpenAPI 3.0.02026-08-1061522.5 KB

24b687a6e18c

Authentication

Get new access and refresh token

To get tokens using your login credentials you will need to set 'grantType' to 'password' and send it together with the 'username' and 'password'. To get tokens using refresh token you will need to set 'grantType' to 'refresh_token' and sent it together with the 'refreshToken'.

post/oauth/token

Request body

grantType'password' | 'refresh_token' required
refreshTokenstring
usernamestring

Employee email address

passwordstring

Example request

{
  "grantType": "password",
  "refreshToken": "SomeRandomStringThatRepresentsRefreshToken",
  "username": "foo@example.com",
  "password": "someRandomPassword"
}

Response

Tokens are successfully created. Copy 'accessToken' and add it to 'Authorization' header in format 'Bearer accessToken'. Access token will expire in 15 minutes so use received 'refreshToken' to generate new tokens

Example response

{
  "token": {
    "tokenType": "Bearer",
    "accessToken": "receivedAccessToken",
    "expiredIn": 900,
    "refreshToken": "receivedRefreshToken"
  }
}