Skip to main content

Get role insights

GET 

https://sailpoint.api.identitynow.com/v2024/role-insights

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.

This method returns detailed role insights for each role.

Request

Query Parameters

    offset int32

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

    Default value: 0
    Example: 0
    limit int32

    Possible values: <= 250

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

    Default value: 250
    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.

    Default value: false
    Example: true
    sorters string

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

    Sorting is supported for the following fields: numberOfUpdates, identitiesWithAccess, totalNumberOfIdentities

    Example: numberOfUpdates
    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

    ownerName: sw

    description: sw

    Example: name sw "John"

Header Parameters

    X-SailPoint-Experimental stringrequired

    Use this header to enable this experimental API.

    Default value: true
    Example: true

Responses

Succeeded. Returns a list of roles with information about insights for each role.

Schema
  • Array [
  • idstring

    Insight id

    Example: 1467e61e-f284-439c-ba2d-c6cc11cf0941
    numberOfUpdatesinteger

    Total number of updates for this role

    Example: 5
    createdDatedate-time

    The date-time insights were last created for this role.

    modifiedDatedate-timenullable

    The date-time insights were last modified for this role.

    Example: 2020-05-19T13:49:37.385Z
    role object
    namestring

    Role name

    Example: Software Engineer
    idstring

    Role id

    Example: 1467e61e-f284-439c-ba2d-c6cc11cf0941
    descriptionstring

    Role description

    Example: Person who develops software
    ownerNamestring

    Role owner name

    Example: Bob
    ownerIdstring

    Role owner id

    Example: 1467e61e-f284-439c-ba2d-c6cc11cf0941
    insight object
    typestring

    The number of identities in this role with the entitlement.

    Example: ADD
    identitiesWithAccessinteger

    The number of identities in this role with the entitlement.

    Example: 850
    identitiesImpactedinteger

    The number of identities in this role that do not have the specified entitlement.

    Example: 150
    totalNumberOfIdentitiesinteger

    The total number of identities.

    Example: 1000
    impactedIdentityNamesstringnullable
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: sp:scopes:all

Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v2024
Auth
Parameters
— headerrequired
— query
— query
— query
— query
— query
ResponseClear

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