Skip to main content

Update Native Change Detection Configuration

PUT 

https://sailpoint.api.identitynow.com/v2024/sources/:sourceId/native-change-detection-config

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.

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

Request

Path Parameters

    id stringrequired

    The source id

    Example: 2c9180835d191a86015d28455b4a2329

Header Parameters

    X-SailPoint-Experimental stringrequired

    Use this header to enable this experimental API.

    Default value: true
    Example: true

Bodyrequired

    enabledboolean

    A flag indicating if Native Change Detection is enabled for a source.

    Default value: false
    Example: true
    operationsstring[]

    Operation types for which Native Change Detection is enabled for a source.

    Possible values: [ACCOUNT_UPDATED, ACCOUNT_CREATED, ACCOUNT_DELETED]

    Example: ["ACCOUNT_UPDATED","ACCOUNT_DELETED"]
    allEntitlementsboolean

    A flag indicating that all entitlements participate in Native Change Detection.

    Default value: false
    Example: false
    allNonEntitlementAttributesboolean

    A flag indicating that all non-entitlement account attributes participate in Native Change Detection.

    Default value: false
    Example: false
    selectedEntitlementsstring[]

    If allEntitlements flag is off this field lists entitlements that participate in Native Change Detection.

    Example: ["memberOf","memberOfSharedMailbox"]
    selectedNonEntitlementAttributesstring[]

    If allNonEntitlementAttributes flag is off this field lists non-entitlement account attributes that participate in Native Change Detection.

    Example: ["lastName","phoneNumber","objectType","servicePrincipalName"]

Responses

Updated native change detection configuration for a source

Schema
    enabledboolean

    A flag indicating if Native Change Detection is enabled for a source.

    Default value: false
    Example: true
    operationsstring[]

    Operation types for which Native Change Detection is enabled for a source.

    Possible values: [ACCOUNT_UPDATED, ACCOUNT_CREATED, ACCOUNT_DELETED]

    Example: ["ACCOUNT_UPDATED","ACCOUNT_DELETED"]
    allEntitlementsboolean

    A flag indicating that all entitlements participate in Native Change Detection.

    Default value: false
    Example: false
    allNonEntitlementAttributesboolean

    A flag indicating that all non-entitlement account attributes participate in Native Change Detection.

    Default value: false
    Example: false
    selectedEntitlementsstring[]

    If allEntitlements flag is off this field lists entitlements that participate in Native Change Detection.

    Example: ["memberOf","memberOfSharedMailbox"]
    selectedNonEntitlementAttributesstring[]

    If allNonEntitlementAttributes flag is off this field lists non-entitlement account attributes that participate in Native Change Detection.

    Example: ["lastName","phoneNumber","objectType","servicePrincipalName"]

Authorization: oauth2

type: Personal Access Token
scopes: idn:sources:update
user levels: ORG_ADMIN
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://sailpoint.api.identitynow.com/v2024/sources/:sourceId/native-change-detection-config"
method := "PUT"

payload := strings.NewReader(`{
"enabled": true,
"operations": [
"ACCOUNT_UPDATED",
"ACCOUNT_DELETED"
],
"allEntitlements": false,
"allNonEntitlementAttributes": false,
"selectedEntitlements": [
"memberOf",
"memberOfSharedMailbox"
],
"selectedNonEntitlementAttributes": [
"lastName",
"phoneNumber",
"objectType",
"servicePrincipalName"
]
}`)

client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Accept", "application/json")
req.Header.Add("Authorization", "Bearer <TOKEN>")

res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()

body, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v2024
Auth
Parameters
— pathrequired
— headerrequired
Body required
{
  "enabled": true,
  "operations": [
    "ACCOUNT_UPDATED",
    "ACCOUNT_DELETED"
  ],
  "allEntitlements": false,
  "allNonEntitlementAttributes": false,
  "selectedEntitlements": [
    "memberOf",
    "memberOfSharedMailbox"
  ],
  "selectedNonEntitlementAttributes": [
    "lastName",
    "phoneNumber",
    "objectType",
    "servicePrincipalName"
  ]
}
ResponseClear

Click the Send API Request button above and see the response here!