Initializing help system before first use

Authentication

Operation Description
GET /insightservices/rest/v1/auth/currentuser

currentUser

GET /insightservices/rest/v1/auth/currentuser/credentials

Get the ID created date of the REST API credentials for the current user

POST /insightservices/rest/v1/auth/currentuser/credentials

Generate new REST API credentials for the current user

DELETE /insightservices/rest/v1/auth/currentuser/credentials

Revoke the REST API credentials for the current user

POST /insightservices/rest/v1/auth/token

Generates a bearer token for the given client for use in an Authorization: Bearer header

GET /insightservices/rest/v1/auth/user

Get the bearer token details for the current user

GET /insightservices/rest/v1/auth/currentuser

currentUser

Responses

application/json

200 OK
Type: UserProfileV1

OK

GET /insightservices/rest/v1/auth/currentuser/credentials

Get the ID created date of the REST API credentials for the current user

Responses

application/json

200 OK
Type: RestApiCredentialsInfoV1

Responds with the ID created date of the REST API credentials for the current user

404 Not Found

The current user has no REST API credentials

POST /insightservices/rest/v1/auth/currentuser/credentials

Generate new REST API credentials for the current user

Request Body

application/json

Responses

application/json

200 OK
Type: RestApiCredentialsV1

Responds with the newly generated REST API credentials for the current user

DELETE /insightservices/rest/v1/auth/currentuser/credentials

Revoke the REST API credentials for the current user

Responses

application/json

204 No Content

The REST API credentials for the current user have been revoked

POST /insightservices/rest/v1/auth/token

Generates a bearer token for the given client for use in an Authorization: Bearer header

Request Body

application/json

Type: RestApiCredentialsForBearerTokenV1

the REST API credentials

Responses

application/json

200 OK

Responds with a new bearer token for the given client

GET /insightservices/rest/v1/auth/user

Get the bearer token details for the current user

Responses

application/json

200 OK
Type: UserTokenInfoV1

Responds with the bearer token details for the current user

RestApiCredentialsForBearerTokenV1: object

REST API credentials to generate a bearer token

Properties

clientId: string

The ID of client

maxAge: integer (int64)

The number of seconds until the generated token will expire

secret: string

The secret used to authorize the client

RestApiCredentialsInfoV1: object

Properties

createdDate: integer (int64)

The date/time when these credentials were created

credentialsId: integer (int64)

The ID of these credentials - incremented for each generation

RestApiCredentialsV1: object

Generated REST API credentials

Properties

clientId: string

The ID of client

createdDate: integer (int64)

The date/time when these credentials were created

credentialsId: integer (int64)

The ID of these credentials - incremented for each generation

secret: string

The secret used to authorize the client

UserProfileV1: object

Properties

objectType: string , x ∈ { USER_PROFILE }
id: string

The id of this user

Example:
"8cf6406a-6e43-402b-95eb-c0a47f8791cc"
firstName: string
Example:
"William"
lastName: string
Example:
"Gates"
displayName: string
Example:
"William Gates"
authorities: string[]

The authorities granted to this user

Array of string
url: string

The URL of this user

Example:
"/insightservices/rest/v1/auth/currentuser"
email: string
authorityGroups: string[]

The custom authorities granted to this user

Array of string
evaluationUser: boolean

Whether this is an evaluation user

UserTokenInfoV1: object

Properties

access_token_expiration_time: string
cn: string
mail: string
uid: string (uuid)

© 2001-2020 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.