Skip to main content

Create a role mining session

POST 

https://sailpoint.api.identitynow.com/beta/role-mining-sessions

This submits a create role mining session request to the role mining application.

Request

Bodyrequired

Role mining session parameters

    scope object
    identityIdsstring[]

    The list of identities for this role mining session.

    Example: ["2c918090761a5aac0176215c46a62d58","2c918090761a5aac01722015c46a62d42"]
    criteriastringnullable

    The "search" criteria that produces the list of identities for this role mining session.

    Example: source.name:DataScienceDataset
    attributeFilterCriteriaobject[]nullable

    The filter criteria for this role mining session.

    Example: {"displayName":{"untranslated":"Location: Miami"},"ariaLabel":{"untranslated":"Location: Miami"},"data":{"displayName":{"translateKey":"IDN.IDENTITY_ATTRIBUTES.LOCATION"},"name":"location","operator":"EQUALS","values":["Miami"]}}
    pruneThresholdint32nullable

    The prune threshold to be used or null to calculate prescribedPruneThreshold

    Example: 50
    prescribedPruneThresholdint32nullable

    The calculated prescribedPruneThreshold

    Example: 10
    minNumIdentitiesInPotentialRoleint32nullable

    Minimum number of identities in a potential role

    Example: 20
    potentialRoleCountint32

    Number of potential roles

    Example: 0
    potentialRolesReadyCountint32

    Number of potential roles ready

    Example: 0
    typestring

    Role type

    Possible values: [SPECIALIZED, COMMON]

    Example: SPECIALIZED
    emailRecipientIdstringnullable

    The id of the user who will receive an email about the role mining session

    Example: 2c918090761a5aac0176215c46a62d58
    identityCountint32

    Number of identities in the population which meet the search criteria or identity list provided

    Example: 0
    savedboolean

    The session's saved status

    Default value: false
    Example: true
    namestringnullable

    The session's saved name

    Example: Saved RM Session - 07/10

Responses

Submitted a role mining session request

Schema
    scope object
    identityIdsstring[]

    The list of identities for this role mining session.

    Example: ["2c918090761a5aac0176215c46a62d58","2c918090761a5aac01722015c46a62d42"]
    criteriastringnullable

    The "search" criteria that produces the list of identities for this role mining session.

    Example: source.name:DataScienceDataset
    attributeFilterCriteriaobject[]nullable

    The filter criteria for this role mining session.

    Example: {"displayName":{"untranslated":"Location: Miami"},"ariaLabel":{"untranslated":"Location: Miami"},"data":{"displayName":{"translateKey":"IDN.IDENTITY_ATTRIBUTES.LOCATION"},"name":"location","operator":"EQUALS","values":["Miami"]}}
    minNumIdentitiesInPotentialRoleintegernullable

    Minimum number of identities in a potential role

    Example: 20
    scopingMethodstringnullable

    The scoping method of the role mining session

    Example: AUTO_RM
    prescribedPruneThresholdintegernullable

    The computed (or prescribed) prune threshold for this session

    Example: 83
    pruneThresholdintegernullable

    The prune threshold to be used for this role mining session

    Example: 70
    potentialRoleCountinteger

    The number of potential roles

    Example: 8
    potentialRolesReadyCountinteger

    The number of potential roles which have completed processing

    Example: 4
    status object

    The role mining session status

    statestring

    Role mining session status

    Possible values: [CREATED, UPDATED, IDENTITIES_OBTAINED, PRUNE_THRESHOLD_OBTAINED, POTENTIAL_ROLES_PROCESSING, POTENTIAL_ROLES_CREATED]

    Example: CREATED
    emailRecipientIdstringnullable

    The id of the user who will receive an email about the role mining session

    createdBy object

    The session created by details

    oneOf
    idstring

    ID of the creator

    Example: 2c918090761a5aac0176215c46a62d58
    displayNamestring

    The display name of the creator

    Example: Ashley.Pierce
    identityCountinteger

    The number of identities

    Example: 39
    savedboolean

    The session's saved status

    Default value: false
    Example: true
    namestringnullable

    The session's saved name

    Example: Saved RM Session - 07/10
    dataFilePathstringnullable

    The data file path of the role mining session

    idstring

    Session Id for this role mining session

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

    The date-time when this role mining session was created.

    modifiedDatedate-time

    The date-time when this role mining session was completed.

    typestring

    Role type

    Possible values: [SPECIALIZED, COMMON]

    Example: SPECIALIZED

Authorization: oauth2

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

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

func main() {

url := "https://sailpoint.api.identitynow.com/beta/role-mining-sessions"
method := "POST"

payload := strings.NewReader(`{
"scope": {
"identityIds": [
"2c918090761a5aac0176215c46a62d58",
"2c918090761a5aac01722015c46a62d42"
],
"criteria": "source.name:DataScienceDataset",
"attributeFilterCriteria": {
"displayName": {
"untranslated": "Location: Miami"
},
"ariaLabel": {
"untranslated": "Location: Miami"
},
"data": {
"displayName": {
"translateKey": "IDN.IDENTITY_ATTRIBUTES.LOCATION"
},
"name": "location",
"operator": "EQUALS",
"values": [
"Miami"
]
}
}
},
"pruneThreshold": 50,
"prescribedPruneThreshold": 10,
"minNumIdentitiesInPotentialRole": 20,
"potentialRoleCount": 0,
"potentialRolesReadyCount": 0,
"type": "SPECIALIZED",
"emailRecipientId": "2c918090761a5aac0176215c46a62d58",
"identityCount": 0,
"saved": true,
"name": "Saved RM Session - 07/10"
}`)

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/beta
Auth
Body required
{
  "scope": {
    "identityIds": [
      "2c918090761a5aac0176215c46a62d58",
      "2c918090761a5aac01722015c46a62d42"
    ],
    "criteria": "source.name:DataScienceDataset",
    "attributeFilterCriteria": {
      "displayName": {
        "untranslated": "Location: Miami"
      },
      "ariaLabel": {
        "untranslated": "Location: Miami"
      },
      "data": {
        "displayName": {
          "translateKey": "IDN.IDENTITY_ATTRIBUTES.LOCATION"
        },
        "name": "location",
        "operator": "EQUALS",
        "values": [
          "Miami"
        ]
      }
    }
  },
  "pruneThreshold": 50,
  "prescribedPruneThreshold": 10,
  "minNumIdentitiesInPotentialRole": 20,
  "potentialRoleCount": 0,
  "potentialRolesReadyCount": 0,
  "type": "SPECIALIZED",
  "emailRecipientId": "2c918090761a5aac0176215c46a62d58",
  "identityCount": 0,
  "saved": true,
  "name": "Saved RM Session - 07/10"
}
ResponseClear

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