Skip to main content

Retrieve status of a potential role export job

GET 

/role-mining-sessions/:sessionId/potential-roles/:potentialRoleId/export-async/:exportId

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 endpoint retrieves information about the current status of a potential role export.

Request

Path Parameters

    sessionId uuidrequired

    The role mining session id

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

    A potential role id in a role mining session

    Example: 278359a6-04b7-4669-9468-924cf580964a
    exportId uuidrequired

    The id of a previously run export job for this potential role

    Example: 4940ffd4-836f-48a3-b2b0-6d498c3fdf40

Header Parameters

    X-SailPoint-Experimental stringrequired

    Default value: true

    Use this header to enable this experimental API.

    Example: true

Responses

Success. Returns the current status of this export

Schema

    minEntitlementPopularity integer

    The minimum popularity among identities in the role which an entitlement must have to be included in the report

    includeCommonAccess boolean

    If false, do not include entitlements that are highly popular among the entire orginization

    exportId uuid

    ID used to reference this export

    status RoleMiningPotentialRoleExportState (string)

    Possible values: [QUEUED, IN_PROGRESS, SUCCESS, ERROR]

    The status of this export

Loading...