Skip to main content

Get identities for a suggested entitlement (for a role)

GET 

/role-insights/:insightId/entitlement-changes/:entitlementId/identities

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.

Role insights suggests entitlements to be added for a role. This endpoint returns a list of identities in the role, with or without the entitlements, for a suggested entitlement so that the user can see which identities would be affected if the suggested entitlement were to be added to the role.

Request

Path Parameters

    insightId stringrequired

    The role insight id

    Example: 8c190e67-87aa-4ed9-a90b-d9d5344523fb
    entitlementId stringrequired

    The entitlement id

    Example: 8c190e67-87aa-4ed9-a90b-d9d5344523fb

Query Parameters

    hasEntitlement boolean

    Identity has this entitlement or not

    offset int32

    Default value: 0

    Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.

    Example: 0
    limit int32

    Possible values: <= 250

    Default value: 250

    Max number of results to return. See V3 API Standard Collection Parameters for more information.

    Example: 250
    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=true if that value will not be used.

    See V3 API Standard Collection Parameters for more information.

    Example: true
    sorters string

    Sort results using the standard syntax described in V3 API Standard Collection Parameters

    Sorting is supported for the following fields: name

    Example: name
    filters string

    Filter results using the standard syntax described in V3 API Standard Collection Parameters

    Filtering is supported for the following fields and operators:

    name: sw

    Example: name sw "Jan"

Header Parameters

    X-SailPoint-Experimental stringrequired

    Default value: true

    Use this header to enable this experimental API.

    Example: true

Responses

Succeeded. Returns a list of identities with or without the entitlement.

Schema

  • Array [

  • id string

    Id for identity

    name string

    Name for identity

    attributes

    object

    property name* string
  • ]

Loading...