latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

Role Mining

Search

Search role mining suggestions by name, description, or cohort filter values with optional state and type filters. Each suggestion row is large (cohort filters, entitlements, insights, profile matches) — request a small page_size (≤10) to keep responses small.

post/api/v1/search/role-mining/suggestions

Request body

cohortTypesstring[] nullable

Filter by cohort type (e.g. "department", "job_title", "manager").

matchTypesstring[] nullable

Filter by match type against existing access profiles.

pageSizeinteger

Maximum number of suggestions to return per page.

pageTokenstring

Pagination token from a previous response.

querystring

Text search — matches against suggested_name, description, and cohort filter values.

statesstring[] nullable

Filter by suggestion state.

Response

Successful response

nextPageTokenstring

Token to retrieve the next page of results, empty if no more results.