Skip to main content

IAIRecommendationsService

Every method returns an Observable. All request paths are relative to the baseUrl you pass to provideSailPoint().

MethodHTTP requestDescription
get-recommendations-config-v1GET /recommendations/v1/configGet certification recommendation config values
get-recommendations-v1POST /recommendations/v1/requestReturns recommendation based on object
update-recommendations-config-v1PUT /recommendations/v1/configUpdate certification recommendation config values

get-recommendations-config-v1

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

Get certification recommendation config values Retrieves configuration attributes used by certification recommendations.

API Spec

Parameters

The service takes one object that holds every parameter. Its type is GetRecommendationsConfigV1RequestParams.

NameTypeDescriptionNotes
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<RecommendationConfigDto>

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import { Component, inject } from '@angular/core';
import { IAIRecommendationsService } from '@sailpoint/angular-sdk/iai_recommendations';

@Component({ selector: 'app-example', template: '' })
export class ExampleComponent {
private readonly api = inject(IAIRecommendationsService);

getRecommendationsConfigV1(): void {
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.getRecommendationsConfigV1({ }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-recommendations-v1

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

Returns recommendation based on object The getRecommendations API returns recommendations based on the requested object. The recommendations are invoked by IdentityIQ and IdentityNow plug-ins that retrieve recommendations based on the performed calculations.

API Spec

Parameters

The service takes one object that holds every parameter. Its type is GetRecommendationsV1RequestParams.

NameTypeDescriptionNotes
recommendationRequestDtoRecommendationRequestDto
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<RecommendationResponseDto>

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import { Component, inject } from '@angular/core';
import { IAIRecommendationsService } from '@sailpoint/angular-sdk/iai_recommendations';
import { RecommendationRequestDto } from '@sailpoint/angular-sdk/iai_recommendations';

@Component({ selector: 'app-example', template: '' })
export class ExampleComponent {
private readonly api = inject(IAIRecommendationsService);

getRecommendationsV1(): void {
const recommendationRequestDto: RecommendationRequestDto = ; //
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.getRecommendationsV1({ recommendationRequestDto: recommendationRequestDto }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-recommendations-config-v1

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

Update certification recommendation config values Updates configuration attributes used by certification recommendations.

API Spec

Parameters

The service takes one object that holds every parameter. Its type is UpdateRecommendationsConfigV1RequestParams.

NameTypeDescriptionNotes
recommendationConfigDtoRecommendationConfigDto
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<RecommendationConfigDto>

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import { Component, inject } from '@angular/core';
import { IAIRecommendationsService } from '@sailpoint/angular-sdk/iai_recommendations';
import { RecommendationConfigDto } from '@sailpoint/angular-sdk/iai_recommendations';

@Component({ selector: 'app-example', template: '' })
export class ExampleComponent {
private readonly api = inject(IAIRecommendationsService);

updateRecommendationsConfigV1(): void {
const recommendationConfigDto: RecommendationConfigDto = ; //
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.updateRecommendationsConfigV1({ recommendationConfigDto: recommendationConfigDto }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]