Identity Access Request Recommendations
GET {{baseUrl}}/ai-access-request-recommendations
This API returns the access request recommendations for the specified identity. The default identity is me which indicates the current user.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
identity-id | string | Get access request recommendations for an identityId. me indicates the current user. | |
limit | number | Max number of results to return. | |
offset | number | Offset into the full result set. Usually specified with limit to paginate through the results. | |
| See V3 API Standard Collection Parameters for more information. | |||
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. |
| include-translation-messages | boolean | | If true it will populate a list of translation messages in the response. |
| filters | string | | Filter results using the standard syntax described in V3 API Standard Collection Parameters
Filtering is supported for the following fields and operators:
access.name: co
access.type: eq, in
access.description: co, eq, in |
| sorters | string | | Sort results using the standard syntax described in V3 API Standard Collection Parameters
Sorting is supported for the following fields: access.name, access.type
By default the recommendations are sorted by highest confidence first. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-SailPoint-Experimental | boolean | (Required) Use this header to enable this experimental API. | |
Accept | string |
RESPONSES
status: OK
[{"identityId":"2c91808570313110017040b06f344ec9","access":{"id":"2c9180835d2e5168015d32f890ca1581","type":"ACCESS_PROFILE","name":"Employee-database-read-write","description":"This item grants an employee read and write access to the database"},"ignored":true,"requested":true,"viewed":true,"messages":[{"interpretation":"95% of your peers have this access."},{"interpretation":"95% of your peers have this access."}],"translationMessages":[{"key":"recommender-api.V2_WEIGHT_FEATURE_PRODUCT_INTERPRETATION_HIGH","values":["75","department"]}]},{"identityId":"2c91808570313110017040b06f344ec9","access":{"id":"2c9180835d2e5168015d32f890ca1581","type":"ACCESS_PROFILE","name":"Employee-database-read-write","description":"This item grants an employee read and write access to the database"},"ignored":true,"requested":true,"viewed":true,"messages":[{"interpretation":"95% of your peers have this access."},{"interpretation":"95% of your peers have this access."}],"translationMessages":[{"key":"recommender-api.V2_WEIGHT_FEATURE_PRODUCT_INTERPRETATION_HIGH","values":["75","department"]}]}]