EMemma
Authentication

Refresh token

Returns an access token for this API using a refresh token. The refresh token enables you to get a new access token (when it is expired) without needing the Client ID and Client Secret. To get the access token, you need to send the refresh token in the payload. You can obtain the refresh token from the /v1/issue-token endpoint.

post/v1/refresh-token

Request

  • Base URL
    https://api.emma.ms/external
  • Auth
    none declared

Request body

refreshTokenstring required

Refresh token. You can obtain a refresh token from the /v1/issue-token endpoint

Example request

{
  "refreshToken": "ad6f8c5js6dkj;s43dv3jljhf9fxej4236235tgdgrthreth8044b84864e2"
}

Response

Successful operation

otherClaimsobject
accessTokenstring

Access token

expiresIninteger

Seconds until access token expiration

refreshExpiresIninteger

Seconds until refresh token expiration

refreshTokenstring

Refresh token

tokenTypestring

Token type

idTokeninteger nullable
notBeforePolicyinteger

Timestamp before which the token is not valid

sessionStatestring

Example response

{
  "accessToken": "eyJhbGcih3In0.eyJleHAiOjE3MDA2Mzc4NjksImlhdCI6MTcwMDYzNzU2OSwianRpIjoiYTMwOGRhMDItYmIwNy00MjVkLTk2NzUtNzFiMjczNzdkMjYxIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLmVtbWEubXMvYXV0aC9yZWFsbXMvZW1tYSIsImF1ZCI6ImFjY291bnQiLCJzdWIiOiIzMDg1YzdlOS1kYjExLT.VCXC-D43-8zp7FVYSNgbbz8KUASAWlFcCqj6wJwif_FReGSIofgDoya54bIBPEugVq0Is7TmbBaXCzkEEASxkMxrCg7r6-7XBWC3P5w8It8Kc-wdVRgjVGSnzz4B8hA",
  "expiresIn": 300,
  "refreshExpiresIn": 1800,
  "refreshToken": "eyJhIwOGIyYi00YzgwLTQ5NTQtODY4Ni02YmY2OWJiYjg0ZjcifQ.eyJleHAiOjE3MDA2MzkzNjksImlhdCI6MTcwMDYzNzU2OSwianRpIjoiYTIxMjRmZWQtODA5MS00ZDAyLTljtYXBpIiwic2Vzc2lvbl9zdGF0ZSI6IjMzZmNlMWQzLWM1MWUtNDY5Zi1iMmNiLTQ0YzY3YjRmNTEyZSIsInNjb3BlIjoidXNlckF0dHJpYnV0ZSBw",
  "tokenType": "Bearer",
  "notBeforePolicy": 1668610246,
  "sessionState": "33fce1d3-c51e-469f-b2cb-44c67b4f512e"
}

Changes

No recorded changes to this operation across all 1 revision of this API.