Skip to main content

IdentityHistoryService

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

MethodHTTP requestDescription
compare-identity-snapshots-access-type-v1GET /historical-identities/v1/{id}/compare/Gets a list of differences of specific accesstype for the given identity between 2 snapshots
compare-identity-snapshots-v1GET /historical-identities/v1/{id}/compareGets a difference of count for each access item types for the given identity between 2 snapshots
get-historical-identity-events-v1GET /historical-identities/v1/{id}/eventsList identity event history
get-historical-identity-v1GET /historical-identities/v1/{id}Get latest snapshot of identity
get-identity-snapshot-summary-v1GET /historical-identities/v1/{id}/snapshot-summaryGets the summary for the event count for a specific identity
get-identity-snapshot-v1GET /historical-identities/v1/{id}/snapshots/{date}Gets an identity snapshot at a given date
get-identity-start-date-v1GET /historical-identities/v1/{id}/start-dateGets the start date of the identity
list-historical-identities-v1GET /historical-identities/v1Lists all the identities
list-identity-access-items-v1GET /historical-identities/v1/{id}/access-itemsList access items by identity
list-identity-snapshot-access-items-v1GET /historical-identities/v1/{id}/snapshots/{date}/access-itemsGets the list of identity access items at a given date filterd by item type
list-identity-snapshots-v1GET /historical-identities/v1/{id}/snapshotsLists all the snapshots for the identity

compare-identity-snapshots-access-type-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.

Gets a list of differences of specific accesstype for the given identity between 2 snapshots This method gets a list of differences of specific accessType for the given identity between 2 snapshots Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
accessType`'accessProfile''account''app'
accessAssociatedbooleanIndicates if added or removed access needs to be returned. true - added, false - removed, null - both added & removed[optional] [default to undefined]
snapshot1stringThe snapshot 1 of identity[optional] [default to undefined]
snapshot2stringThe snapshot 2 of identity[optional] [default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<AccessItemDiff>>

HTTP request headers

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

Example

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

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

compareIdentitySnapshotsAccessTypeV1(): void {
const id: string = ; // The identity id
const accessType: string = ; // The specific type which needs to be compared
const accessAssociated: boolean = ; // Indicates if added or removed access needs to be returned. true - added, false - removed, null - both added &amp; removed (optional)
const snapshot1: string = ; // The snapshot 1 of identity (optional)
const snapshot2: string = ; // The snapshot 2 of identity (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.compareIdentitySnapshotsAccessTypeV1({ id: id, accessType: accessType }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

compare-identity-snapshots-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.

Gets a difference of count for each access item types for the given identity between 2 snapshots This method gets a difference of count for each access item types for the given identity between 2 snapshots Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
snapshot1stringThe snapshot 1 of identity[optional] [default to undefined]
snapshot2stringThe snapshot 2 of identity[optional] [default to undefined]
accessItemTypesArray<string>An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned[optional] [default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<IdentityCompareResponse>>

HTTP request headers

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

Example

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

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

compareIdentitySnapshotsV1(): void {
const id: string = ; // The identity id
const snapshot1: string = ; // The snapshot 1 of identity (optional)
const snapshot2: string = ; // The snapshot 2 of identity (optional)
const accessItemTypes: Array<string> = ; // An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.compareIdentitySnapshotsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-historical-identity-events-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.

List identity event history This method retrieves all access events for the identity Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
fromstringThe optional instant until which access events are returned[optional] [default to undefined]
eventTypesArray<string>An optional list of event types to return. If null or empty, all events are returned[optional] [default to undefined]
accessItemTypesArray<string>An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned[optional] [default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<GetHistoricalIdentityEventsV1200ResponseInner>>

HTTP request headers

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

Example

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

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

getHistoricalIdentityEventsV1(): void {
const id: string = ; // The identity id
const from: string = ; // The optional instant until which access events are returned (optional)
const eventTypes: Array<string> = ; // An optional list of event types to return. If null or empty, all events are returned (optional)
const accessItemTypes: Array<string> = ; // An optional list of access item types (app, account, entitlement, etc...) to return. If null or empty, all access items types are returned (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.getHistoricalIdentityEventsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-historical-identity-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 latest snapshot of identity This method retrieves a specified identity Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<IdentityHistoryResponse>

HTTP request headers

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

Example

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

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

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

[Back to top]

get-identity-snapshot-summary-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.

Gets the summary for the event count for a specific identity This method gets the summary for the event count for a specific identity by month/day Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
beforestringThe date before which snapshot summary is required[optional] [default to undefined]
interval`'day''month'`The interval indicating day or month. Defaults to month if not specified
timeZonestringThe time zone. Defaults to UTC if not provided[optional] [default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<MetricResponse>>

HTTP request headers

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

Example

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

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

getIdentitySnapshotSummaryV1(): void {
const id: string = ; // The identity id
const before: string = ; // The date before which snapshot summary is required (optional)
const interval: string = ; // The interval indicating day or month. Defaults to month if not specified (optional)
const timeZone: string = ; // The time zone. Defaults to UTC if not provided (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.getIdentitySnapshotSummaryV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-identity-snapshot-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.

Gets an identity snapshot at a given date This method retrieves a specified identity snapshot at a given date Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
datestringThe specified date[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<IdentityHistoryResponse>

HTTP request headers

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

Example

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

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

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

[Back to top]

get-identity-start-date-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.

Gets the start date of the identity This method retrieves start date of the identity Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<string>

HTTP request headers

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

Example

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

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

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

[Back to top]

list-historical-identities-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.

Lists all the identities This gets the list of identities for the customer. This list end point does not support count=true request param. The total count of identities would never be returned even if the count param is specified in the request Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
startsWithQuerystringThis param is used for starts-with search for first, last and display name of the identity[optional] [default to undefined]
isDeletedbooleanIndicates if we want to only list down deleted identities or not.[optional] [default to undefined]
isActivebooleanIndicates if we want to only list active or inactive identities.[optional] [default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<IdentityListItem>>

HTTP request headers

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

Example

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

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

listHistoricalIdentitiesV1(): void {
const startsWithQuery: string = ; // This param is used for starts-with search for first, last and display name of the identity (optional)
const isDeleted: boolean = ; // Indicates if we want to only list down deleted identities or not. (optional)
const isActive: boolean = ; // Indicates if we want to only list active or inactive identities. (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.listHistoricalIdentitiesV1({ }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-identity-access-items-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.

List access items by identity This method retrieves a list of access item for the identity filtered by the access item type

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
type`'account''entitlement''app'
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]

Return type

Observable<Array<ListIdentityAccessItemsV1200ResponseInner>>

HTTP request headers

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

Example

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

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

listIdentityAccessItemsV1(): void {
const id: string = ; // The identity id
const type: string = ; // The type of access item for the identity. If not provided, it defaults to account (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
this.api.listIdentityAccessItemsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-identity-snapshot-access-items-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.

Gets the list of identity access items at a given date filterd by item type This method retrieves the list of identity access items at a given date filterd by item type Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
datestringThe specified date[default to undefined]
typestringThe access item type[optional] [default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<ListIdentitySnapshotAccessItemsV1200ResponseInner>>

HTTP request headers

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

Example

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

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

listIdentitySnapshotAccessItemsV1(): void {
const id: string = ; // The identity id
const date: string = ; // The specified date
const type: string = ; // The access item type (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.listIdentitySnapshotAccessItemsV1({ id: id, date: date }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-identity-snapshots-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.

Lists all the snapshots for the identity This method retrieves all the snapshots for the identity Requires authorization scope of 'idn:identity-history:read'

API Spec

Parameters

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

NameTypeDescriptionNotes
idstringThe identity id[default to undefined]
startstringThe specified start date[optional] [default to undefined]
interval`'day''month'`The interval indicating the range in day or month for the specified interval-name
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used. See V3 API Standard Collection Parameters for more information.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type

Observable<Array<IdentitySnapshotSummaryResponse>>

HTTP request headers

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

Example

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

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

listIdentitySnapshotsV1(): void {
const id: string = ; // The identity id
const start: string = ; // The specified start date (optional)
const interval: string = ; // The interval indicating the range in day or month for the specified interval-name (optional)
const limit: number = ; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = ; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const count: boolean = ; // If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count&#x3D;true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.listIdentitySnapshotsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]