COconductorone
Role Mining

Search

Changed on

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

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/search/role-mining/suggestions
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

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.

Changes

  • f2cf3228f366Revision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

  • f6e337c979e4Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property ////// to the response with the status