MicroStrategy REST API API Documentation
Validate an identity token
GET {{baseUrl}}/api/auth/identityToken
Validate an identity token. An identity token is used to share an existing session with another application, based on the authorization token for the existing session. An identity token allows the other application to log in on behalf of the authenticated user, creating a new authorization token. You obtain the identity token needed to execute the request using POST /auth/identityToken; you pass the original authorization token in the request header. This request returns the DSSID for the authenticated user whose session will be shared using the identity token.
Body
PARAM
| Key | Datatype | Required | Description |
fields
|
null | Comma-separated, top-level field whitelist that allows the client to selectively retrieve part of the response model. If specified, extra filtering is applied, and for top-level object (if root model is an array, each array element), only the listed fields are kept in the response. For example, "id,elements" keeps only the "id" field and whole "elements" array field, omitting all other fields in the top-level response model. |
HEADERS
| Key | Datatype | Required | Description |
X-MSTR-IdentityToken
|
string | (Required) Identity token |
RESPONSES
status OK
| {
"userId": "7FC05A65473CE2FD845CE6A1D3F13233"
} |
Curl
curl -X GET 'baseUrl/api/auth/identityToken?fields=' -H 'X-MSTR-IdentityToken: identityToken'
ENDPOINTS