Skip to main content

SourcesService

Use this API to implement and customize source functionality. With source functionality in place, organizations can use Identity Security Cloud to connect their various sources and user data sets and manage access across all those different sources in a secure, scalable way.

Sources refer to the Identity Security Cloud representations for external applications, databases, and directory management systems that maintain their own sets of users, like Dropbox, GitHub, and Workday, for example. Organizations may use hundreds, if not thousands, of different source systems, and any one employee within an organization likely has a different user record on each source, often with different permissions on many of those records. Connecting these sources to Identity Security Cloud makes it possible to manage user access across them all. Then, if a new hire starts at an organization, Identity Security Cloud can grant the new hire access to all the sources they need. If an employee moves to a new department and needs access to new sources but no longer needs access to others, Identity Security Cloud can grant the necessary access and revoke the unnecessary access for all the employee's various sources. If an employee leaves the company, Identity Security Cloud can revoke access to all the employee's various source accounts immediately. These are just a few examples of the many ways that source functionality makes identity governance easier, more efficient, and more secure.

In Identity Security Cloud, administrators can create configure, manage, and edit sources, and they can designate other users as source admins to be able to do so. They can also designate users as source sub-admins, who can perform the same source actions but only on sources associated with their governance groups. Admins go to Connections > Sources to see a list of the existing source representations in their organizations. They can create new sources or select existing ones.

To create a new source, the following must be specified: Source Name, Description, Source Owner, and Connection Type. Refer to Configuring a Source for more information about the source configuration process.

Identity Security Cloud connects with its sources either by a direct communication with the source server (connection information specific to the source must be provided) or a flat file feed, a CSV file containing all the relevant information about the accounts to be loaded in. Different sources use different connectors to share data with Identity Security Cloud, and each connector's setup process is specific to that connector. SailPoint has built a number of connectors to come out of the box and connect to the most common sources, and SailPoint actively maintains these connectors. Refer to Identity Security Cloud Connectors for more information about these SailPoint supported connectors. Refer to the following links for more information about two useful connectors:

  • JDBC Connector: This customizable connector an directly connect to databases that support JDBC (Java Database Connectivity).

  • Web Services Connector: This connector can directly connect to databases that support Web Services.

Refer to SaaS Connectivity for more information about SailPoint's new connectivity framework that makes it easy to build and manage custom connectors to SaaS sources.

When admins select existing sources, they can view the following information about the source:

  • Associated connections (any associated identity profiles, apps, or references to the source in a transform).

  • Associated user accounts. These accounts are linked to their identities - this provides a more complete picture of each user's access across sources.

  • Associated entitlements (sets of access rights on sources).

  • Associated access profiles (groupings of entitlements).

The user account data and the entitlements update with each data aggregation from the source. Organizations generally run scheduled, automated data aggregations to ensure that their data is always in sync between their sources and their Identity Security Cloud tenants so an access change on a source is detected quickly in Identity Security Cloud. Admins can view a history of these aggregations, and they can also run manual imports. Refer to Loading Account Data for more information about manual and scheduled aggregations.

Admins can also make changes to determine which user account data Identity Security Cloud collects from the source and how it correlates that account data with identity data. To define which account attributes the source shares with Identity Security Cloud, admins can edit the account schema on the source. Refer to Managing Source Account Schemas for more information about source account schemas and how to edit them. To define the mapping between the source account attributes and their correlating identity attributes, admins can edit the correlation configuration on the source. Refer to Assigning Source Accounts to Identities for more information about this correlation process between source accounts and identities.

Admins can also delete sources, but they must first ensure that the sources no longer have any active connections: the source must not be associated with any identity profile or any app, and it must not be referenced by any transform. Refer to Deleting Sources for more information about deleting sources.

Well organized, mapped out connections between sources and Identity Security Cloud are essential to achieving comprehensive identity access governance across all the source systems organizations need. Refer to Managing Sources for more information about all the different things admins can do with sources once they are connected.

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

MethodHTTP requestDescription
create-provisioning-policy-v1POST /sources/v1/{sourceId}/provisioning-policiesCreate provisioning policy
create-provisioning-policy-v2POST /sources/v2/{sourceId}/provisioning-policiesCreate provisioning policy
create-source-dataset-v1POST /sources/v1/{sourceId}/datasetsCreate dataset on source
create-source-resource-v1POST /sources/v1/{sourceId}/resourcesCreate resource on source
create-source-schedule-v1POST /sources/v1/{sourceId}/schedulesCreate schedule on source
create-source-schema-v1POST /sources/v1/{sourceId}/schemasCreate schema on source
create-source-v1POST /sources/v1Create source
delete-accounts-async-v1POST /sources/v1/{id}/remove-accountsRemove all accounts in source
delete-native-change-detection-config-v1DELETE /sources/v1/{sourceId}/native-change-detection-configDelete native change detection configuration
delete-provisioning-policy-v1DELETE /sources/v1/{sourceId}/provisioning-policies/{usageType}Delete provisioning policy by usagetype
delete-provisioning-policy-v2DELETE /sources/v2/{sourceId}/provisioning-policies/{id}Delete provisioning policy by ID
delete-source-dataset-objects-v1POST /sources/v1/{sourceId}/datasets/{datasetId}/delete-objectsDelete objects for source dataset
delete-source-dataset-v1DELETE /sources/v1/{sourceId}/datasets/{datasetId}Delete source dataset by id
delete-source-resource-v1DELETE /sources/v1/{sourceId}/resources/{resourceId}Delete source resource by id
delete-source-schedule-v1DELETE /sources/v1/{sourceId}/schedules/{scheduleType}Delete source schedule by type.
delete-source-schema-v1DELETE /sources/v1/{sourceId}/schemas/{schemaId}Delete source schema by id
delete-source-v1DELETE /sources/v1/{id}Delete source by id
get-account-delete-approval-config-v1GET /sources/v1/{sourceId}/approval-config/account-deleteHuman Account Deletion Approval Config
get-accounts-schema-v1GET /sources/v1/{id}/schemas/accountsDownloads source accounts schema template
get-correlation-config-v1GET /sources/v1/{id}/correlation-configGet source correlation configuration
get-entitlements-schema-v1GET /sources/v1/{id}/schemas/entitlementsDownloads source entitlements schema template
get-machine-account-deletion-approval-config-by-source-v1GET /sources/v1/{sourceId}/approval-config/machine-account-deleteMachine Account Deletion Approval Config
get-native-change-detection-config-v1GET /sources/v1/{sourceId}/native-change-detection-configNative change detection configuration
get-provisioning-policy-v1GET /sources/v1/{sourceId}/provisioning-policies/{usageType}Get provisioning policy by usagetype
get-provisioning-policy-v2GET /sources/v2/{sourceId}/provisioning-policies/{id}Get provisioning policy by ID
get-source-attr-sync-config-v1GET /sources/v1/{id}/attribute-sync-configAttribute sync config
get-source-config-v1GET /sources/v1/{id}/connectors/source-configGets source config with language-translations
get-source-connections-v1GET /sources/v1/{sourceId}/connectionsGet source connections by id
get-source-dataset-v1GET /sources/v1/{sourceId}/datasets/{datasetId}Get source dataset by id
get-source-datasets-v1GET /sources/v1/{sourceId}/datasetsList datasets on source
get-source-entitlement-request-config-v1GET /sources/v1/{id}/entitlement-request-configGet source entitlement request configuration
get-source-health-v1GET /sources/v1/{sourceId}/source-healthFetches source health by id
get-source-resource-mappings-v1GET /sources/v1/{sourceId}/resources/mappingsGet source resource mappings
get-source-resource-v1GET /sources/v1/{sourceId}/resources/{resourceId}Get source resource by id
get-source-resources-v1GET /sources/v1/{sourceId}/resourcesList resources for a source
get-source-schedule-v1GET /sources/v1/{sourceId}/schedules/{scheduleType}Get source schedule by type
get-source-schedules-v1GET /sources/v1/{sourceId}/schedulesList schedules on source
get-source-schema-v1GET /sources/v1/{sourceId}/schemas/{schemaId}Get source schema by id
get-source-schemas-v1GET /sources/v1/{sourceId}/schemasList schemas on source
get-source-v1GET /sources/v1/{id}Get source by id
import-accounts-schema-v1POST /sources/v1/{id}/schemas/accountsUploads source accounts schema template
import-accounts-v1POST /sources/v1/{id}/load-accountsAccount aggregation
import-connector-file-v1POST /sources/v1/{sourceId}/upload-connector-fileUpload connector file to source
import-entitlements-schema-v1POST /sources/v1/{id}/schemas/entitlementsUploads source entitlements schema template
import-entitlements-v1POST /sources/v1/{sourceId}/load-entitlementsEntitlement aggregation
import-source-dataset-v1POST /sources/v1/{sourceId}/datasets/{datasetId}/aggregateAggregate source dataset
import-uncorrelated-accounts-v1POST /sources/v1/{id}/load-uncorrelated-accountsProcess uncorrelated accounts
list-password-policy-holders-on-source-v1GET /sources/v1/{sourceId}/password-policiesGet Password Policy for source
list-provisioning-policies-v1GET /sources/v1/{sourceId}/provisioning-policiesLists provisioningpolicies
list-provisioning-policies-v2GET /sources/v2/{sourceId}/provisioning-policiesLists Provisioning Policies
list-sources-v1GET /sources/v1List sources
ping-cluster-v1POST /sources/v1/{sourceId}/connector/ping-clusterPing cluster for source connector
put-correlation-config-v1PUT /sources/v1/{id}/correlation-configUpdate source correlation configuration
put-native-change-detection-config-v1PUT /sources/v1/{sourceId}/native-change-detection-configUpdate native change detection configuration
put-provisioning-policy-v1PUT /sources/v1/{sourceId}/provisioning-policies/{usageType}Update provisioning policy by usagetype
put-provisioning-policy-v2PUT /sources/v2/{sourceId}/provisioning-policies/{id}Update provisioning policy by ID
put-source-attr-sync-config-v1PUT /sources/v1/{id}/attribute-sync-configUpdate attribute sync config
put-source-dataset-v1PUT /sources/v1/{sourceId}/datasets/{datasetId}Update source dataset (full)
put-source-resource-v1PUT /sources/v1/{sourceId}/resources/{resourceId}Update source resource (full)
put-source-schema-v1PUT /sources/v1/{sourceId}/schemas/{schemaId}Update source schema (full)
put-source-v1PUT /sources/v1/{id}Update source (full)
search-resource-objects-v1POST /sources/v1/{sourceId}/connector/peek-resource-objectsPeek source connector's resource objects
sync-attributes-for-source-v1POST /sources/v1/{id}/synchronize-attributesSynchronize single source attributes.
test-source-configuration-v1POST /sources/v1/{sourceId}/connector/test-configurationTest configuration for source connector
test-source-connection-v1POST /sources/v1/{sourceId}/connector/check-connectionCheck connection for source connector.
update-account-deletion-approval-config-v1PATCH /sources/v1/{sourceId}/approval-config/account-deleteHuman Account Deletion Approval Config
update-machine-account-deletion-approval-config-v1PATCH /sources/v1/{sourceId}/approval-config/machine-account-deleteMachine Account Deletion Approval Config
update-password-policy-holders-v1PATCH /sources/v1/{sourceId}/password-policiesUpdate password policy
update-provisioning-policies-in-bulk-v1POST /sources/v1/{sourceId}/provisioning-policies/bulk-updateBulk update provisioning policies
update-provisioning-policy-v1PATCH /sources/v1/{sourceId}/provisioning-policies/{usageType}Partial update of provisioning policy
update-provisioning-policy-v2PATCH /sources/v2/{sourceId}/provisioning-policies/{id}Partial update of provisioning policy
update-source-dataset-v1PATCH /sources/v1/{sourceId}/datasets/{datasetId}Update source dataset (partial)
update-source-entitlement-request-config-v1PUT /sources/v1/{id}/entitlement-request-configUpdate source entitlement request configuration
update-source-resource-v1PATCH /sources/v1/{sourceId}/resources/{resourceId}Update source resource (partial)
update-source-schedule-v1PATCH /sources/v1/{sourceId}/schedules/{scheduleType}Update source schedule (partial)
update-source-schema-v1PATCH /sources/v1/{sourceId}/schemas/{schemaId}Update source schema (partial)
update-source-v1PATCH /sources/v1/{id}Update source (partial)

create-provisioning-policy-v1​

Create provisioning policy This API generates a create policy/template based on field value transforms. This API is intended for use when setting up JDBC Provisioning type sources, but it will also work on other source types. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
provisioningPolicyDtoProvisioningPolicyDto

Return type​

Observable<ProvisioningPolicyDto>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ProvisioningPolicyDto } from '@sailpoint/angular-sdk/sources';

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

createProvisioningPolicyV1(): void {
const sourceId: string = ; // The Source id
const provisioningPolicyDto: ProvisioningPolicyDto = ; //
this.api.createProvisioningPolicyV1({ sourceId: sourceId, provisioningPolicyDto: provisioningPolicyDto }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

create-provisioning-policy-v2​

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.

Create provisioning policy This API generates a create policy/template based on field value transforms. This API is intended for use when setting up JDBC Provisioning type sources, but it will also work on other source types. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. The V2 API allows you to use a unique identifier (id) for each provisioning policy instead of usageType. This enables read, update, and delete operations on policies using their id. Note: The subtypeId field is required if usageType is CREATE_MACHINE_ACCOUNT. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
provisioningPolicyDtoV2ProvisioningPolicyDtoV2
useDefaultFieldsbooleanIf passed as true, then it uses default fields from the connector template.[optional] [default to false]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<ProvisioningPolicyDtoV2>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ProvisioningPolicyDtoV2 } from '@sailpoint/angular-sdk/sources';

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

createProvisioningPolicyV2(): void {
const sourceId: string = ; // The Source id
const provisioningPolicyDtoV2: ProvisioningPolicyDtoV2 = ; //
const useDefaultFields: boolean = ; // If passed as true, then it uses default fields from the connector template. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.createProvisioningPolicyV2({ sourceId: sourceId, provisioningPolicyDtoV2: provisioningPolicyDtoV2 }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

create-source-dataset-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.

Create dataset on source Use this API to create a dataset on the specified source in Identity Security Cloud (ISC).

This operation requires a connector with the supportDatasetCreation label. name is required. The dataset id is always server-generated from name as customer: plus a normalized form of the name; any client-supplied id is ignored.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
sourceDatasetSourceDataset
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDataset>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { SourceDataset } from '@sailpoint/angular-sdk/sources';

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

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

[Back to top]

create-source-resource-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.

Create resource on source Use this API to create a resource on the specified source in Identity Security Cloud (ISC).

This operation requires a connector with the supportDatasetCreation label. name, type, datasetId, and schema are required. The schema must define at least one attribute plus identityAttribute and displayAttribute. The resource id is always server-generated from name as customer: plus a normalized form of the name; any client-supplied id is ignored. After creation, schema attribute edits are made through the source schema APIs.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
sourceDatasetResourceSourceDatasetResource
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDatasetResource>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { SourceDatasetResource } from '@sailpoint/angular-sdk/sources';

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

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

[Back to top]

create-source-schedule-v1​

Create schedule on source Use this API to create a new schedule for a type on the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
schedule3Schedule3

Return type​

Observable<Schedule3>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { Schedule3 } from '@sailpoint/angular-sdk/sources';

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

createSourceScheduleV1(): void {
const sourceId: string = ; // Source ID.
const schedule3: Schedule3 = ; //
this.api.createSourceScheduleV1({ sourceId: sourceId, schedule3: schedule3 }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

create-source-schema-v1​

Create schema on source Use this API to create a new schema on the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
schemaSchema

Return type​

Observable<Schema>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { Schema } from '@sailpoint/angular-sdk/sources';

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

createSourceSchemaV1(): void {
const sourceId: string = ; // Source ID.
const schema: Schema = ; //
this.api.createSourceSchemaV1({ sourceId: sourceId, schema: schema }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

create-source-v1​

Create source This creates a specific source with a full source JSON representation. Any passwords are submitted as plain-text and encrypted upon receipt.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceSource
provisionAsCsvbooleanIf this parameter is `true`, it configures the source as a Delimited File (CSV) source. Setting this to `true` will automatically set the `type` of the source to `DelimitedFile`. You must use this query parameter to create a Delimited File source as you would in the UI. If you don&#39;t set this query parameter and you attempt to set the `type` attribute directly, the request won&#39;t correctly generate the source.[optional] [default to false]

Return type​

Observable<Source>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { Source } from '@sailpoint/angular-sdk/sources';

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

createSourceV1(): void {
const source: Source = ; //
const provisionAsCsv: boolean = ; // If this parameter is &#x60;true&#x60;, it configures the source as a Delimited File (CSV) source. Setting this to &#x60;true&#x60; will automatically set the &#x60;type&#x60; of the source to &#x60;DelimitedFile&#x60;. You must use this query parameter to create a Delimited File source as you would in the UI. If you don\&#39;t set this query parameter and you attempt to set the &#x60;type&#x60; attribute directly, the request won\&#39;t correctly generate the source. (optional)
this.api.createSourceV1({ source: source }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-accounts-async-v1​

Remove all accounts in source Use this endpoint to remove all accounts from the system without provisioning changes to the source. Accounts that are removed could be re-created during the next aggregation.

This endpoint is good for:

  • Removing accounts that no longer exist on the source.
  • Removing accounts that won't be aggregated following updates to the source configuration.
  • Forcing accounts to be re-created following the next aggregation to re-run account processing, support testing, etc.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe source id[default to undefined]

Return type​

Observable<TaskResultDto>

HTTP request headers​

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

Example​

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

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

deleteAccountsAsyncV1(): void {
const id: string = ; // The source id
this.api.deleteAccountsAsyncV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-native-change-detection-config-v1​

Delete native change detection configuration Deletes the native change detection configuration for the source specified by the given ID.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe source id[default to undefined]

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

deleteNativeChangeDetectionConfigV1(): void {
const sourceId: string = ; // The source id
this.api.deleteNativeChangeDetectionConfigV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-provisioning-policy-v1​

Delete provisioning policy by usagetype Deletes the provisioning policy with the specified usage on an application.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
usageTypeUsageTypeThe type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to &#39;Create Account Profile&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to &#39;Update Account Profile&#39;, the provisioning template for the &#39;Update&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to &#39;Enable Account Profile&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner&#39;s account is created. DISABLE - This usage type relates to &#39;Disable Account Profile&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.[default to undefined]

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

deleteProvisioningPolicyV1(): void {
const sourceId: string = ; // The Source ID.
const usageType: UsageType = ; // The type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to \&#39;Create Account Profile\&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to \&#39;Update Account Profile\&#39;, the provisioning template for the \&#39;Update\&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to \&#39;Enable Account Profile\&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner\&#39;s account is created. DISABLE - This usage type relates to \&#39;Disable Account Profile\&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.
this.api.deleteProvisioningPolicyV1({ sourceId: sourceId, usageType: usageType }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-provisioning-policy-v2​

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.

Delete provisioning policy by ID Deletes the provisioning policy with the specified ID on an application.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
idstringThe provisioning policy ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

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

[Back to top]

delete-source-dataset-objects-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.

Delete objects for source dataset Starts a task to delete aggregated objects for the specified dataset on the source in Identity Security Cloud (ISC). Linked dataset and resource definitions are not deleted.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<TaskResultDetails>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

delete-source-dataset-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.

Delete source dataset by id Use this API to delete a dataset on the specified source in Identity Security Cloud (ISC).

This operation requires a connector with the supportDatasetCreation label. Linked resource schemas are not deleted.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

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

[Back to top]

delete-source-resource-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.

Delete source resource by id Use this API to delete a resource on the specified source in Identity Security Cloud (ISC).

The resource schema is deleted and the resource is unlinked from any dataset rows on the source.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
resourceIdstringResource ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

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

[Back to top]

delete-source-schedule-v1​

Delete source schedule by type.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
scheduleType`'ACCOUNT_AGGREGATION''GROUP_AGGREGATION'`The Schedule type.

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

deleteSourceScheduleV1(): void {
const sourceId: string = ; // The Source id.
const scheduleType: string = ; // The Schedule type.
this.api.deleteSourceScheduleV1({ sourceId: sourceId, scheduleType: scheduleType }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-source-schema-v1​

Delete source schema by id

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
schemaIdstringThe Schema id.[default to undefined]

Return type​

Observable<void> (empty response body)

HTTP request headers​

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

Example​

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

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

deleteSourceSchemaV1(): void {
const sourceId: string = ; // The Source id.
const schemaId: string = ; // The Schema id.
this.api.deleteSourceSchemaV1({ sourceId: sourceId, schemaId: schemaId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

delete-source-v1​

Delete source by id Use this API to delete a specific source in Identity Security Cloud (ISC). The API removes all the accounts on the source first, and then it deletes the source. You can retrieve the actual task execution status with this method: GET /task-status/{id}

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource ID.[default to undefined]

Return type​

Observable<DeleteSourceV1202Response>

HTTP request headers​

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

Example​

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

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

deleteSourceV1(): void {
const id: string = ; // Source ID.
this.api.deleteSourceV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-account-delete-approval-config-v1​

Human Account Deletion Approval Config The endpoint retrieves the approval configuration for deleting human accounts from a specified source. It returns details such as whether approval is required, who the approvers are, and any additional approval settings. This helps administrators understand and manage the approval workflow for human account deletions in their organization. The response is provided as an AccountDeleteConfigDto object.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]

Return type​

Observable<AccountDeleteConfigDto>

HTTP request headers​

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

Example​

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

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

getAccountDeleteApprovalConfigV1(): void {
const sourceId: string = ; // The Source id
this.api.getAccountDeleteApprovalConfigV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-accounts-schema-v1​

Downloads source accounts schema template This API downloads the CSV schema that defines the account attributes on a source.

NOTE: This API is designated only for Delimited File sources.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]

Return type​

Observable<void> (empty response body)

HTTP request headers​

  • Content-Type: Not defined
  • Accept: text/csv, application/json

Example​

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

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

getAccountsSchemaV1(): void {
const id: string = ; // The Source id
this.api.getAccountsSchemaV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-correlation-config-v1​

Get source correlation configuration This API returns the existing correlation configuration for a source specified by the given ID.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe source id[default to undefined]

Return type​

Observable<CorrelationConfig>

HTTP request headers​

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

Example​

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

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

getCorrelationConfigV1(): void {
const id: string = ; // The source id
this.api.getCorrelationConfigV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-entitlements-schema-v1​

Downloads source entitlements schema template This API downloads the CSV schema that defines the entitlement attributes on a source.

NOTE: This API is designated only for Delimited File sources.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]
schemaNamestringName of entitlement schema[optional] [default to undefined]

Return type​

Observable<void> (empty response body)

HTTP request headers​

  • Content-Type: Not defined
  • Accept: text/csv, application/json

Example​

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

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

getEntitlementsSchemaV1(): void {
const id: string = ; // The Source id
const schemaName: string = ; // Name of entitlement schema (optional)
this.api.getEntitlementsSchemaV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-machine-account-deletion-approval-config-by-source-v1​

Machine Account Deletion Approval Config Retrieves the machine account deletion approval configuration for a specific source. This endpoint returns details about the approval requirements, approvers, and comment settings that govern the deletion of machine accounts associated with the given source ID.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringsource id.[default to undefined]

Return type​

Observable<AccountDeleteConfigDto>

HTTP request headers​

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

Example​

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

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

getMachineAccountDeletionApprovalConfigBySourceV1(): void {
const sourceId: string = ; // source id.
this.api.getMachineAccountDeletionApprovalConfigBySourceV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-native-change-detection-config-v1​

Native change detection configuration This API returns the existing native change detection configuration for a source specified by the given ID.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe source id[default to undefined]

Return type​

Observable<NativeChangeDetectionConfig>

HTTP request headers​

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

Example​

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

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

getNativeChangeDetectionConfigV1(): void {
const sourceId: string = ; // The source id
this.api.getNativeChangeDetectionConfigV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-provisioning-policy-v1​

Get provisioning policy by usagetype This end-point retrieves the ProvisioningPolicy with the specified usage on the specified Source in IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
usageTypeUsageTypeThe type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to &#39;Create Account Profile&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to &#39;Update Account Profile&#39;, the provisioning template for the &#39;Update&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to &#39;Enable Account Profile&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner&#39;s account is created. DISABLE - This usage type relates to &#39;Disable Account Profile&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.[default to undefined]

Return type​

Observable<ProvisioningPolicyDto>

HTTP request headers​

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

Example​

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

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

getProvisioningPolicyV1(): void {
const sourceId: string = ; // The Source ID.
const usageType: UsageType = ; // The type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to \&#39;Create Account Profile\&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to \&#39;Update Account Profile\&#39;, the provisioning template for the \&#39;Update\&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to \&#39;Enable Account Profile\&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner\&#39;s account is created. DISABLE - This usage type relates to \&#39;Disable Account Profile\&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.
this.api.getProvisioningPolicyV1({ sourceId: sourceId, usageType: usageType }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-provisioning-policy-v2​

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 provisioning policy by ID This end-point retrieves the ProvisioningPolicy with the specified ID on the specified Source in Identity Security Cloud.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
idstringThe provisioning policy ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<ProvisioningPolicyDtoV2>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

get-source-attr-sync-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.

Attribute sync config This API returns the existing attribute synchronization configuration for a source specified by the given ID. The response contains all attributes, regardless of whether they enabled or not.

API Spec

Parameters​

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

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

Return type​

Observable<AttrSyncSourceConfig>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

get-source-config-v1​

Gets source config with language-translations Looks up and returns the source config for the requested source id after populating the source config values and applying language translations.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]
locale`'de''false''fi'

Return type​

Observable<ConnectorDetail>

HTTP request headers​

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

Example​

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

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

getSourceConfigV1(): void {
const id: string = ; // The Source id
const locale: string = ; // The locale to apply to the config. If no viable locale is given, it will default to \&quot;en\&quot; (optional)
this.api.getSourceConfigV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-connections-v1​

Get source connections by id Use this API to get all dependent Profiles, Attributes, Applications and Custom Transforms for a source by a specified ID in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]

Return type​

Observable<SourceConnectionsDto>

HTTP request headers​

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

Example​

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

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

getSourceConnectionsV1(): void {
const sourceId: string = ; // Source ID.
this.api.getSourceConnectionsV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-dataset-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 source dataset by id Use this API to get a dataset by id for the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDataset>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

get-source-datasets-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 datasets on source Use this API to list datasets for the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[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<SourceDataset>>

HTTP request headers​

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

Example​

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

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

getSourceDatasetsV1(): void {
const sourceId: string = ; // Source ID.
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.getSourceDatasetsV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-entitlement-request-config-v1​

Get source entitlement request configuration This API gets the current entitlement request configuration for a source. This source-level configuration should apply for all the entitlements in the source.

Access request to any entitlements in the source should follow this configuration unless a separate entitlement-level configuration is defined.

  • During access request, this source-level entitlement request configuration overrides the global organization-level configuration.
  • However, the entitlement-level configuration (if defined) overrides this source-level configuration.

The WORKFLOW approver type is not supported in source-level configuration. To use a workflow as an approver, configure it on the entitlement with Replace entitlement request config. A source-level request that contains WORKFLOW fails with a 400.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]

Return type​

Observable<SourceEntitlementRequestConfig>

HTTP request headers​

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

Example​

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

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

getSourceEntitlementRequestConfigV1(): void {
const id: string = ; // The Source id
this.api.getSourceEntitlementRequestConfigV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-health-v1​

Fetches source health by id This endpoint fetches source health by source's id

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]

Return type​

Observable<SourceHealthDto>

HTTP request headers​

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

Example​

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

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

getSourceHealthV1(): void {
const sourceId: string = ; // The Source id.
this.api.getSourceHealthV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-resource-mappings-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 source resource mappings Use this API to get aggregation metadata for resources on the specified source in Identity Security Cloud (ISC). The response is keyed by resource id. Each value includes the linked dataset id, resource type, and connector object type. Resources without a matching schema are omitted.

API Spec

Parameters​

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

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

Return type​

Observable<{ [key: string]: SourceResourceMappingValue; }>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

get-source-resource-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 source resource by id Use this API to get a resource by id on the specified source in Identity Security Cloud (ISC). The response includes the full CIS schema for the resource.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
resourceIdstringResource ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDatasetResource>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

get-source-resources-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 resources for a source Use this API to list resources defined on the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[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<SourceDatasetResource>>

HTTP request headers​

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

Example​

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

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

getSourceResourcesV1(): void {
const sourceId: string = ; // Source ID.
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.getSourceResourcesV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-schedule-v1​

Get source schedule by type Get the source schedule by type in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
scheduleType`'ACCOUNT_AGGREGATION''GROUP_AGGREGATION'`The Schedule type.

Return type​

Observable<Schedule3>

HTTP request headers​

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

Example​

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

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

getSourceScheduleV1(): void {
const sourceId: string = ; // The Source id.
const scheduleType: string = ; // The Schedule type.
this.api.getSourceScheduleV1({ sourceId: sourceId, scheduleType: scheduleType }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-schedules-v1​

List schedules on source Use this API to list the schedules that exist on the specified source in Identity Security Cloud (ISC).

info

This endpoint uses a cron expression to schedule a task, following standard cron job syntax.

For example, 0 0 12 1/1 * ? * runs the task daily at 12:00 PM.

Days of the week are represented as 1-7 (Sunday-Saturday).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]

Return type​

Observable<Array<Schedule3>>

HTTP request headers​

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

Example​

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

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

getSourceSchedulesV1(): void {
const sourceId: string = ; // Source ID.
this.api.getSourceSchedulesV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-schema-v1​

Get source schema by id Get the Source Schema by ID in IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
schemaIdstringThe Schema id.[default to undefined]

Return type​

Observable<Schema>

HTTP request headers​

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

Example​

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

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

getSourceSchemaV1(): void {
const sourceId: string = ; // The Source id.
const schemaId: string = ; // The Schema id.
this.api.getSourceSchemaV1({ sourceId: sourceId, schemaId: schemaId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-schemas-v1​

List schemas on source Use this API to list the schemas that exist on the specified source in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
includeTypes`'group''user'`If set to &#39;group&#39;, then the account schema is filtered and only group schemas are returned. Only a value of &#39;group&#39; is recognized presently. Note: The API will check whether include-types is group or not, if not, it will list schemas based on include-names, if include-names is not provided, it will list all schemas.
includeNamesstringA comma-separated list of schema names to filter result.[optional] [default to undefined]

Return type​

Observable<Array<Schema>>

HTTP request headers​

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

Example​

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

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

getSourceSchemasV1(): void {
const sourceId: string = ; // Source ID.
const includeTypes: string = ; // If set to \&#39;group\&#39;, then the account schema is filtered and only group schemas are returned. Only a value of \&#39;group\&#39; is recognized presently. Note: The API will check whether include-types is group or not, if not, it will list schemas based on include-names, if include-names is not provided, it will list all schemas. (optional)
const includeNames: string = ; // A comma-separated list of schema names to filter result. (optional)
this.api.getSourceSchemasV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

get-source-v1​

Get source by id Use this API to get a source by a specified ID in Identity Security Cloud (ISC).

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource ID.[default to undefined]

Return type​

Observable<Source>

HTTP request headers​

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

Example​

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

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

getSourceV1(): void {
const id: string = ; // Source ID.
this.api.getSourceV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-accounts-schema-v1​

Uploads source accounts schema template This API uploads a source schema template file to configure a source's account attributes.

To retrieve the file to modify and upload, log into Identity Now.

Click Admin -> Connections -> Sources -> {SourceName} -> Import Data -> Account Schema -> Options -> Download Schema

NOTE: This API is designated only for Delimited File sources.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]
fileBlob[optional] [default to undefined]

Return type​

Observable<Schema>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importAccountsSchemaV1(): void {
const id: string = ; // The Source id
const file: Blob = ; // (optional)
this.api.importAccountsSchemaV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-accounts-v1​

Account aggregation Starts an account aggregation on the specified source. If the target source is a delimited file source, then the CSV file needs to be included in the request body. You will also need to set the Content-Type header to multipart/form-data.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource Id[default to undefined]
fileBlobThe CSV file containing the source accounts to aggregate.[optional] [default to undefined]
disableOptimizationstringUse this flag to reprocess every account whether or not the data has changed.[optional] [default to undefined]

Return type​

Observable<LoadAccountsTask>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importAccountsV1(): void {
const id: string = ; // Source Id
const file: Blob = ; // The CSV file containing the source accounts to aggregate. (optional)
const disableOptimization: string = ; // Use this flag to reprocess every account whether or not the data has changed. (optional)
this.api.importAccountsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-connector-file-v1​

Upload connector file to source This uploads a supplemental source connector file (like jdbc driver jars) to a source's S3 bucket. This also sends ETS and Audit events.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
fileBlob[optional] [default to undefined]

Return type​

Observable<Source>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importConnectorFileV1(): void {
const sourceId: string = ; // The Source id.
const file: Blob = ; // (optional)
this.api.importConnectorFileV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-entitlements-schema-v1​

Uploads source entitlements schema template This API uploads a source schema template file to configure a source's entitlement attributes.

To retrieve the file to modify and upload, log into Identity Now.

Click Admin -> Connections -> Sources -> {SourceName} -> Import Data -> Import Entitlements -> Download

NOTE: This API is designated only for Delimited File sources.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]
schemaNamestringName of entitlement schema[optional] [default to undefined]
fileBlob[optional] [default to undefined]

Return type​

Observable<Schema>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importEntitlementsSchemaV1(): void {
const id: string = ; // The Source id
const schemaName: string = ; // Name of entitlement schema (optional)
const file: Blob = ; // (optional)
this.api.importEntitlementsSchemaV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-entitlements-v1​

Entitlement aggregation Starts an entitlement aggregation on the specified source. If the target source is a delimited file source, then the CSV file needs to be included in the request body. You will also need to set the Content-Type header to multipart/form-data. A token with ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource Id[default to undefined]
fileBlobThe CSV file containing the source entitlements to aggregate.[optional] [default to undefined]

Return type​

Observable<LoadEntitlementTask>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importEntitlementsV1(): void {
const sourceId: string = ; // Source Id
const file: Blob = ; // The CSV file containing the source entitlements to aggregate. (optional)
this.api.importEntitlementsV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-source-dataset-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.

Aggregate source dataset Starts an aggregation for the specified dataset on the source in Identity Security Cloud (ISC). An optional config object can be supplied for connector-specific aggregation settings.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']
datasetAggregationRequestDatasetAggregationRequest[optional]

Return type​

Observable<TaskResultDetails>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { DatasetAggregationRequest } from '@sailpoint/angular-sdk/sources';

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

importSourceDatasetV1(): void {
const sourceId: string = ; // Source ID.
const datasetId: string = ; // Dataset ID.
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
const datasetAggregationRequest: DatasetAggregationRequest = ; // (optional)
this.api.importSourceDatasetV1({ sourceId: sourceId, datasetId: datasetId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

import-uncorrelated-accounts-v1​

Process uncorrelated accounts File is required for upload. You will also need to set the Content-Type header to multipart/form-data

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource Id[default to undefined]
fileBlob[optional] [default to undefined]

Return type​

Observable<LoadUncorrelatedAccountsTask>

HTTP request headers​

  • Content-Type: multipart/form-data
  • Accept: application/json

Example​

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

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

importUncorrelatedAccountsV1(): void {
const id: string = ; // Source Id
const file: Blob = ; // (optional)
this.api.importUncorrelatedAccountsV1({ id: id }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-password-policy-holders-on-source-v1​

Get Password Policy for source This API can be used to get Password Policy in IdentityNow for the specified Source. Source must support PASSWORD feature.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
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]
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]

Return type​

Observable<Array<PasswordPolicyHoldersDtoInner>>

HTTP request headers​

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

Example​

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

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

listPasswordPolicyHoldersOnSourceV1(): void {
const sourceId: string = ; // The Source id
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 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)
this.api.listPasswordPolicyHoldersOnSourceV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-provisioning-policies-v1​

Lists provisioningpolicies This end-point lists all the ProvisioningPolicies in IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
offsetnumberOffset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in V3 API Standard Collection Parameters. The offset value is record-based, not page-based, and the index starts at 0.[optional] [default to 0]
limitnumberLimit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in V3 API Standard Collection Parameters. If it is not specified, a default limit is used.[optional] [default to 250]

Return type​

Observable<Array<ProvisioningPolicyDto>>

HTTP request headers​

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

Example​

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

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

listProvisioningPoliciesV1(): void {
const sourceId: string = ; // The Source id
const offset: number = ; // Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional)
const limit: number = ; // Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional)
this.api.listProvisioningPoliciesV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-provisioning-policies-v2​

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 Provisioning Policies This end-point lists all the ProvisioningPolicies in IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
filtersstringFilter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: subtypeId: eq usageType: eq[optional] [default to undefined]
offsetnumberOffset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in V3 API Standard Collection Parameters. The offset value is record-based, not page-based, and the index starts at 0.[optional] [default to 0]
limitnumberLimit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in V3 API Standard Collection Parameters. If it is not specified, a default limit is used.[optional] [default to 250]
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<Array<ProvisioningPolicyDtoV2>>

HTTP request headers​

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

Example​

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

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

listProvisioningPoliciesV2(): void {
const sourceId: string = ; // The Source id
const filters: string = ; // Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **subtypeId**: *eq* **usageType**: *eq* (optional)
const offset: number = ; // Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional)
const limit: number = ; // Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional)
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.listProvisioningPoliciesV2({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

list-sources-v1​

List sources This end-point lists all the sources.

API Spec

Parameters​

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

NameTypeDescriptionNotes
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]
filtersstringFilter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: id: eq, in, ge, gt, le, lt, ne, isnull, sw name: co, eq, in, sw, ge, gt, ne, isnull type: eq, in, ge, gt, ne, isnull, sw owner.id: eq, in, ge, gt, le, lt, ne, isnull, sw features: ca, co created: eq, ge, gt, in, le, lt, ne, isnull, sw modified: eq, ge, gt, in, le, lt, ne, isnull, sw managementWorkgroup.id: eq, ge, gt, in, le, lt, ne, isnull, sw description: eq, sw authoritative: eq, ne, isnull healthy: isnull status: eq, in, ge, gt, le, lt, ne, isnull, sw connectionType: eq, ge, gt, in, le, lt, ne, isnull, sw connectorName: eq, ge, gt, in, ne, isnull, sw category: co, eq, ge, gt, in, le, lt, ne, sw[optional] [default to undefined]
sortersstringSort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: type, created, modified, name, owner.name, healthy, status, id, description, owner.id, accountCorrelationConfig.id, accountCorrelationConfig.name, managerCorrelationRule.type, managerCorrelationRule.id, managerCorrelationRule.name, authoritative, managementWorkgroup.id, connectorName, connectionType[optional] [default to undefined]
forSubadminstringFilter the returned list of sources for the identity specified by the parameter, which is the id of an identity with the role SOURCE_SUBADMIN. By convention, the value me indicates the identity id of the current user. Subadmins may only view Sources which they are able to administer; all other Sources will be filtered out when this parameter is set. If the current user is a SOURCE_SUBADMIN but fails to pass a valid value for this parameter, a 403 Forbidden is returned.[optional] [default to undefined]
includeIDNSourcebooleanInclude the IdentityNow source in the response.[optional] [default to false]

Return type​

Observable<Array<Source>>

HTTP request headers​

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

Example​

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

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

listSourcesV1(): void {
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 filters: string = ; // Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in, ge, gt, le, lt, ne, isnull, sw* **name**: *co, eq, in, sw, ge, gt, ne, isnull* **type**: *eq, in, ge, gt, ne, isnull, sw* **owner.id**: *eq, in, ge, gt, le, lt, ne, isnull, sw* **features**: *ca, co* **created**: *eq, ge, gt, in, le, lt, ne, isnull, sw* **modified**: *eq, ge, gt, in, le, lt, ne, isnull, sw* **managementWorkgroup.id**: *eq, ge, gt, in, le, lt, ne, isnull, sw* **description**: *eq, sw* **authoritative**: *eq, ne, isnull* **healthy**: *isnull* **status**: *eq, in, ge, gt, le, lt, ne, isnull, sw* **connectionType**: *eq, ge, gt, in, le, lt, ne, isnull, sw* **connectorName**: *eq, ge, gt, in, ne, isnull, sw* **category**: *co, eq, ge, gt, in, le, lt, ne, sw* (optional)
const sorters: string = ; // Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **type, created, modified, name, owner.name, healthy, status, id, description, owner.id, accountCorrelationConfig.id, accountCorrelationConfig.name, managerCorrelationRule.type, managerCorrelationRule.id, managerCorrelationRule.name, authoritative, managementWorkgroup.id, connectorName, connectionType** (optional)
const forSubadmin: string = ; // Filter the returned list of sources for the identity specified by the parameter, which is the id of an identity with the role SOURCE_SUBADMIN. By convention, the value **me** indicates the identity id of the current user. Subadmins may only view Sources which they are able to administer; all other Sources will be filtered out when this parameter is set. If the current user is a SOURCE_SUBADMIN but fails to pass a valid value for this parameter, a 403 Forbidden is returned. (optional)
const includeIDNSource: boolean = ; // Include the IdentityNow source in the response. (optional)
this.api.listSourcesV1({ }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

ping-cluster-v1​

Ping cluster for source connector This endpoint validates that the cluster being used by the source is reachable from IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe ID of the Source[default to undefined]

Return type​

Observable<StatusResponse>

HTTP request headers​

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

Example​

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

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

pingClusterV1(): void {
const sourceId: string = ; // The ID of the Source
this.api.pingClusterV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-correlation-config-v1​

Update source correlation configuration Replaces the correlation configuration for the source specified by the given ID with the configuration provided in the request body.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe source id[default to undefined]
correlationConfigCorrelationConfig

Return type​

Observable<CorrelationConfig>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { CorrelationConfig } from '@sailpoint/angular-sdk/sources';

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

putCorrelationConfigV1(): void {
const id: string = ; // The source id
const correlationConfig: CorrelationConfig = ; //
this.api.putCorrelationConfigV1({ id: id, correlationConfig: correlationConfig }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-native-change-detection-config-v1​

Update native change detection configuration Replaces the native change detection configuration for the source specified by the given ID with the configuration provided in the request body.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe source id[default to undefined]
nativeChangeDetectionConfigNativeChangeDetectionConfig

Return type​

Observable<NativeChangeDetectionConfig>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { NativeChangeDetectionConfig } from '@sailpoint/angular-sdk/sources';

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

putNativeChangeDetectionConfigV1(): void {
const sourceId: string = ; // The source id
const nativeChangeDetectionConfig: NativeChangeDetectionConfig = ; //
this.api.putNativeChangeDetectionConfigV1({ sourceId: sourceId, nativeChangeDetectionConfig: nativeChangeDetectionConfig }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-provisioning-policy-v1​

Update provisioning policy by usagetype This end-point updates the provisioning policy with the specified usage on the specified source in IdentityNow. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
usageTypeUsageTypeThe type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to &#39;Create Account Profile&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to &#39;Update Account Profile&#39;, the provisioning template for the &#39;Update&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to &#39;Enable Account Profile&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner&#39;s account is created. DISABLE - This usage type relates to &#39;Disable Account Profile&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.[default to undefined]
provisioningPolicyDtoProvisioningPolicyDto

Return type​

Observable<ProvisioningPolicyDto>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ProvisioningPolicyDto } from '@sailpoint/angular-sdk/sources';

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

putProvisioningPolicyV1(): void {
const sourceId: string = ; // The Source ID.
const usageType: UsageType = ; // The type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to \&#39;Create Account Profile\&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to \&#39;Update Account Profile\&#39;, the provisioning template for the \&#39;Update\&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to \&#39;Enable Account Profile\&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner\&#39;s account is created. DISABLE - This usage type relates to \&#39;Disable Account Profile\&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.
const provisioningPolicyDto: ProvisioningPolicyDto = ; //
this.api.putProvisioningPolicyV1({ sourceId: sourceId, usageType: usageType, provisioningPolicyDto: provisioningPolicyDto }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-provisioning-policy-v2​

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 provisioning policy by ID This end-point updates the provisioning policy with the specified ID on the specified source in Identity Security Cloud. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source ID.[default to undefined]
idstringThe provisioning policy ID.[default to undefined]
provisioningPolicyDtoV2ProvisioningPolicyDtoV2
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<ProvisioningPolicyDtoV2>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ProvisioningPolicyDtoV2 } from '@sailpoint/angular-sdk/sources';

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

putProvisioningPolicyV2(): void {
const sourceId: string = ; // The Source ID.
const id: string = ; // The provisioning policy ID.
const provisioningPolicyDtoV2: ProvisioningPolicyDtoV2 = ; //
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.putProvisioningPolicyV2({ sourceId: sourceId, id: id, provisioningPolicyDtoV2: provisioningPolicyDtoV2 }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-source-attr-sync-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 attribute sync config Replaces the attribute synchronization configuration for the source specified by the given ID with the configuration provided in the request body. Only the "enabled" field of the values in the "attributes" array is mutable. Attempting to change other attributes or add new values to the "attributes" array will result in an error.

API Spec

Parameters​

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

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

Return type​

Observable<AttrSyncSourceConfig>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { AttrSyncSourceConfig } from '@sailpoint/angular-sdk/sources';

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

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

[Back to top]

put-source-dataset-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 source dataset (full) Use this API to replace a dataset on the specified source in Identity Security Cloud (ISC).

Callers should round-trip the GET representation. id is required in the request body and must match the path. aggregationEnabled may always be updated. name, description, and resources can be changed only when the connector has the supportDatasetCreation label.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
sourceDatasetSourceDataset
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDataset>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { SourceDataset } from '@sailpoint/angular-sdk/sources';

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

putSourceDatasetV1(): void {
const sourceId: string = ; // Source ID.
const datasetId: string = ; // Dataset ID.
const sourceDataset: SourceDataset = ; //
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.putSourceDatasetV1({ sourceId: sourceId, datasetId: datasetId, sourceDataset: sourceDataset }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-source-resource-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 source resource (full) Use this API to replace a resource on the specified source in Identity Security Cloud (ISC).

After creation, schema attribute edits should be made through the source schema APIs. Connectors with the supportDatasetCreation label can update additional resource fields.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
resourceIdstringResource ID.[default to undefined]
sourceDatasetResourceSourceDatasetResource
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDatasetResource>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { SourceDatasetResource } from '@sailpoint/angular-sdk/sources';

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

putSourceResourceV1(): void {
const sourceId: string = ; // Source ID.
const resourceId: string = ; // Resource ID.
const sourceDatasetResource: SourceDatasetResource = ; //
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.putSourceResourceV1({ sourceId: sourceId, resourceId: resourceId, sourceDatasetResource: sourceDatasetResource }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-source-schema-v1​

Update source schema (full) This API will completely replace an existing Schema with the submitted payload. Some fields of the Schema cannot be updated. These fields are listed below.

  • id
  • name
  • created
  • modified

Any attempt to modify these fields will result in an error response with a status code of 400.

id must remain in the request body, but it cannot be changed. If id is omitted from the request body, the result will be a 400 error.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
schemaIdstringThe Schema id.[default to undefined]
schemaSchema

Return type​

Observable<Schema>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { Schema } from '@sailpoint/angular-sdk/sources';

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

putSourceSchemaV1(): void {
const sourceId: string = ; // The Source id.
const schemaId: string = ; // The Schema id.
const schema: Schema = ; //
this.api.putSourceSchemaV1({ sourceId: sourceId, schemaId: schemaId, schema: schema }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

put-source-v1​

Update source (full) Use this API to update a source in Identity Security Cloud (ISC), using a full object representation. This means that when you use this API, it completely replaces the existing source configuration.

These fields are immutable, so they cannot be changed:

  • id
  • type
  • authoritative
  • connector
  • connectorClass
  • passwordPolicies

Attempts to modify these fields will result in a 400 error.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource ID.[default to undefined]
sourceSource

Return type​

Observable<Source>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { Source } from '@sailpoint/angular-sdk/sources';

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

putSourceV1(): void {
const id: string = ; // Source ID.
const source: Source = ; //
this.api.putSourceV1({ id: id, source: source }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

search-resource-objects-v1​

Peek source connector's resource objects Retrieves a sample of data returned from account and group aggregation requests.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe ID of the Source[default to undefined]
resourceObjectsRequestResourceObjectsRequest

Return type​

Observable<ResourceObjectsResponse>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ResourceObjectsRequest } from '@sailpoint/angular-sdk/sources';

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

searchResourceObjectsV1(): void {
const sourceId: string = ; // The ID of the Source
const resourceObjectsRequest: ResourceObjectsRequest = ; //
this.api.searchResourceObjectsV1({ sourceId: sourceId, resourceObjectsRequest: resourceObjectsRequest }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

sync-attributes-for-source-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.

Synchronize single source attributes. This end-point performs attribute synchronization for a selected source.

API Spec

Parameters​

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

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

Return type​

Observable<SourceSyncJob>

HTTP request headers​

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

Example​

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

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

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

[Back to top]

test-source-configuration-v1​

Test configuration for source connector This endpoint performs a more detailed validation of the source''s configuration that can take longer than the lighter weight credential validation performed by the checkConnection API.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe ID of the Source[default to undefined]

Return type​

Observable<StatusResponse>

HTTP request headers​

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

Example​

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

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

testSourceConfigurationV1(): void {
const sourceId: string = ; // The ID of the Source
this.api.testSourceConfigurationV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

test-source-connection-v1​

Check connection for source connector. This endpoint validates that the configured credentials are valid and will properly authenticate with the source identified by the sourceId path parameter.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe ID of the Source.[default to undefined]

Return type​

Observable<StatusResponse>

HTTP request headers​

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

Example​

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

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

testSourceConnectionV1(): void {
const sourceId: string = ; // The ID of the Source.
this.api.testSourceConnectionV1({ sourceId: sourceId }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-account-deletion-approval-config-v1​

Human Account Deletion Approval Config Updates the approval configuration for deleting human accounts for a specific source, identified by source ID. This endpoint allows administrators to modify settings such as whether approval is required, who the approvers are, and other approval-related options. The update is performed using a JSON Patch payload, and the response returns the updated AccountDeleteConfigDto object reflecting the new approval workflow configuration.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringHuman account source ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the object.

Return type​

Observable<AccountDeleteConfigDto>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateAccountDeletionApprovalConfigV1(): void {
const sourceId: string = ; // Human account source ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the object.
this.api.updateAccountDeletionApprovalConfigV1({ sourceId: sourceId, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-machine-account-deletion-approval-config-v1​

Machine Account Deletion Approval Config Use this endpoint to update the machine account deletion approval configuration for a specific source. The update is performed using a JSON Patch payload, which allows partial modifications to the approval config. This operation is typically used to change approval requirements, approvers, or comments settings for machine account deletion. The endpoint expects the source ID as a path parameter and a valid JSON Patch array in the request body.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringmachine account source ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the object.

Return type​

Observable<AccountDeleteConfigDto>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateMachineAccountDeletionApprovalConfigV1(): void {
const sourceId: string = ; // machine account source ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the object.
this.api.updateMachineAccountDeletionApprovalConfigV1({ sourceId: sourceId, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-password-policy-holders-v1​

Update password policy This API can be used to set up or update Password Policy in IdentityNow for the specified Source. Source must support PASSWORD feature.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id[default to undefined]
passwordPolicyHoldersDtoInnerArray<PasswordPolicyHoldersDtoInner>

Return type​

Observable<Array<PasswordPolicyHoldersDtoInner>>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { PasswordPolicyHoldersDtoInner } from '@sailpoint/angular-sdk/sources';

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

updatePasswordPolicyHoldersV1(): void {
const sourceId: string = ; // The Source id
const passwordPolicyHoldersDtoInner: Array<PasswordPolicyHoldersDtoInner> = ; //
this.api.updatePasswordPolicyHoldersV1({ sourceId: sourceId, passwordPolicyHoldersDtoInner: passwordPolicyHoldersDtoInner }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-provisioning-policies-in-bulk-v1​

Bulk update provisioning policies This end-point updates a list of provisioning policies on the specified source in IdentityNow.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
provisioningPolicyDtoArray<ProvisioningPolicyDto>

Return type​

Observable<Array<ProvisioningPolicyDto>>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { ProvisioningPolicyDto } from '@sailpoint/angular-sdk/sources';

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

updateProvisioningPoliciesInBulkV1(): void {
const sourceId: string = ; // The Source id.
const provisioningPolicyDto: Array<ProvisioningPolicyDto> = ; //
this.api.updateProvisioningPoliciesInBulkV1({ sourceId: sourceId, provisioningPolicyDto: provisioningPolicyDto }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-provisioning-policy-v1​

Partial update of provisioning policy This API selectively updates an existing Provisioning Policy using a JSONPatch payload. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
usageTypeUsageTypeThe type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to &#39;Create Account Profile&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to &#39;Update Account Profile&#39;, the provisioning template for the &#39;Update&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to &#39;Enable Account Profile&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner&#39;s account is created. DISABLE - This usage type relates to &#39;Disable Account Profile&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the schema.

Return type​

Observable<ProvisioningPolicyDto>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateProvisioningPolicyV1(): void {
const sourceId: string = ; // The Source id.
const usageType: UsageType = ; // The type of provisioning policy usage. In IdentityNow, a source can support various provisioning operations. For example, when a joiner is added to a source, this may trigger both CREATE and UPDATE provisioning operations. Each usage type is considered a provisioning policy. A source can have any number of these provisioning policies defined. These are the common usage types: CREATE - This usage type relates to \&#39;Create Account Profile\&#39;, the provisioning template for the account to be created. For example, this would be used for a joiner on a source. UPDATE - This usage type relates to \&#39;Update Account Profile\&#39;, the provisioning template for the \&#39;Update\&#39; connector operations. For example, this would be used for an attribute sync on a source. ENABLE - This usage type relates to \&#39;Enable Account Profile\&#39;, the provisioning template for the account to be enabled. For example, this could be used for a joiner on a source once the joiner\&#39;s account is created. DISABLE - This usage type relates to \&#39;Disable Account Profile\&#39;, the provisioning template for the account to be disabled. For example, this could be used when a leaver is removed temporarily from a source. You can use these four usage types for all your provisioning policy needs.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the schema.
this.api.updateProvisioningPolicyV1({ sourceId: sourceId, usageType: usageType, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-provisioning-policy-v2​

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.

Partial update of provisioning policy This API selectively updates an existing Provisioning Policy using a JSONPatch payload. Transforms can be used in the provisioning policy to create a new attribute that you only need during provisioning. Refer to Transforms in Provisioning Policies for more information.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
idstringThe provisioning policy ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the schema.
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<ProvisioningPolicyDtoV2>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateProvisioningPolicyV2(): void {
const sourceId: string = ; // The Source id.
const id: string = ; // The provisioning policy ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the schema.
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.updateProvisioningPolicyV2({ sourceId: sourceId, id: id, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-dataset-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 source dataset (partial) Use this API to selectively update an existing dataset using a JSONPatch payload.

aggregationEnabled may always be updated. name, description, and resources can be changed only when the connector has the supportDatasetCreation label. id is immutable.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
datasetIdstringDataset ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the dataset.
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDataset>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateSourceDatasetV1(): void {
const sourceId: string = ; // Source ID.
const datasetId: string = ; // Dataset ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the dataset.
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.updateSourceDatasetV1({ sourceId: sourceId, datasetId: datasetId, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-entitlement-request-config-v1​

Update source entitlement request configuration This API replaces the current entitlement request configuration for a source. This source-level configuration should apply for all the entitlements in the source.

Access request to any entitlements in the source should follow this configuration unless a separate entitlement-level configuration is defined.

  • During access request, this source-level entitlement request configuration overrides the global organization-level configuration.
  • However, the entitlement-level configuration (if defined) overrides this source-level configuration.

The WORKFLOW approver type is not supported in source-level configuration. To use a workflow as an approver, configure it on the entitlement with Replace entitlement request config. A source-level request that contains WORKFLOW fails with a 400.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringThe Source id[default to undefined]
sourceEntitlementRequestConfigSourceEntitlementRequestConfig

Return type​

Observable<SourceEntitlementRequestConfig>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { SourceEntitlementRequestConfig } from '@sailpoint/angular-sdk/sources';

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

updateSourceEntitlementRequestConfigV1(): void {
const id: string = ; // The Source id
const sourceEntitlementRequestConfig: SourceEntitlementRequestConfig = ; //
this.api.updateSourceEntitlementRequestConfigV1({ id: id, sourceEntitlementRequestConfig: sourceEntitlementRequestConfig }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-resource-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 source resource (partial) Use this API to selectively update an existing resource using a JSONPatch payload.

After creation, schema attribute edits should be made through the source schema APIs. Connectors with the supportDatasetCreation label can update additional resource fields.

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
resourceIdstringResource ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the resource.
xSailPointExperimentalstringUse this header to enable this experimental API.[optional] [default to 'true']

Return type​

Observable<SourceDatasetResource>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateSourceResourceV1(): void {
const sourceId: string = ; // Source ID.
const resourceId: string = ; // Resource ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the resource.
const xSailPointExperimental: string = ; // Use this header to enable this experimental API. (optional)
this.api.updateSourceResourceV1({ sourceId: sourceId, resourceId: resourceId, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-schedule-v1​

Update source schedule (partial) Use this API to selectively update an existing Schedule using a JSONPatch payload.

The following schedule fields are immutable and cannot be updated:

  • type

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
scheduleType`'ACCOUNT_AGGREGATION''GROUP_AGGREGATION'`The Schedule type.
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the schedule.

Return type​

Observable<Schedule3>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateSourceScheduleV1(): void {
const sourceId: string = ; // The Source id.
const scheduleType: string = ; // The Schedule type.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the schedule.
this.api.updateSourceScheduleV1({ sourceId: sourceId, scheduleType: scheduleType, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-schema-v1​

Update source schema (partial) Use this API to selectively update an existing Schema using a JSONPatch payload.

The following schema fields are immutable and cannot be updated:

  • id
  • name
  • created
  • modified

To switch an account attribute to a group entitlement, you need to have the following in place:

  • isEntitlement: true
  • Must define a schema for the group and add it to the source before updating the isGroup flag. For example, here is the group account attribute referencing a schema that defines the group:
{
"name": "groups",
"type": "STRING",
"schema": {
"type": "CONNECTOR_SCHEMA",
"id": "2c9180887671ff8c01767b4671fc7d60",
"name": "group"
},
"description": "The groups, roles etc. that reference account group objects",
"isMulti": true,
"isEntitlement": true,
"isGroup": true
}

API Spec

Parameters​

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

NameTypeDescriptionNotes
sourceIdstringThe Source id.[default to undefined]
schemaIdstringThe Schema id.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>The JSONPatch payload used to update the schema.

Return type​

Observable<Schema>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateSourceSchemaV1(): void {
const sourceId: string = ; // The Source id.
const schemaId: string = ; // The Schema id.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // The JSONPatch payload used to update the schema.
this.api.updateSourceSchemaV1({ sourceId: sourceId, schemaId: schemaId, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]

update-source-v1​

Update source (partial) Use this API to partially update a source in Identity Security Cloud (ISC), using a list of patch operations according to the JSON Patch standard.

These fields are immutable, so they cannot be changed:

  • id
  • type
  • authoritative
  • created
  • modified
  • connector
  • connectorClass
  • passwordPolicies

Attempts to modify these fields will result in a 400 error.

API Spec

Parameters​

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

NameTypeDescriptionNotes
idstringSource ID.[default to undefined]
jsonPatchOperationArray<JsonPatchOperation>A list of account update operations according to the JSON Patch standard. Any password changes are submitted as plain-text and encrypted upon receipt in Identity Security Cloud (ISC).

Return type​

Observable<Source>

HTTP request headers​

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

Example​

import { Component, inject } from '@angular/core';
import { SourcesService } from '@sailpoint/angular-sdk/sources';
import { JsonPatchOperation } from '@sailpoint/angular-sdk/sources';

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

updateSourceV1(): void {
const id: string = ; // Source ID.
const jsonPatchOperation: Array<JsonPatchOperation> = ; // A list of account update operations according to the [JSON Patch](https://tools.ietf.org/html/rfc6902) standard. Any password changes are submitted as plain-text and encrypted upon receipt in Identity Security Cloud (ISC).
this.api.updateSourceV1({ id: id, jsonPatchOperation: jsonPatchOperation }).subscribe({
next: (result) => console.log(result),
error: (error) => console.error(error),
});
}
}

[Back to top]