# C1 documentation: API Endpoints Role Mining

## Role Mining

- [Create Access Profile From Cohort](https://www.c1.ai/docs/api-reference/role-mining/create-access-profile-from-cohort.md): CreateAccessProfileFromCohort creates an access profile from a cohort definition,  adds the specified entitlements, and sets up dynamic membership automation using  a CEL expression derived from the profile filters.
- [Get Role Mining Config](https://www.c1.ai/docs/api-reference/role-mining/get-role-mining-config.md): Retrieve the current role mining configuration, including cohort hints and threshold settings.
- [Update Role Mining Config](https://www.c1.ai/docs/api-reference/role-mining/update-role-mining-config.md): Update the role mining configuration, such as cohort hints, max suggestions, and minimum cohort size.
- [List Custom Analysis Results](https://www.c1.ai/docs/api-reference/role-mining/list-custom-analysis-results.md): List recent custom analysis results in reverse chronological order.
- [Evaluate Entitlement Selection](https://www.c1.ai/docs/api-reference/role-mining/evaluate-entitlement-selection.md): Evaluate the exact cohort impact of an entitlement cutoff and manual overrides.  The analysis determines the eligible entitlements and cohort definition.
- [Get Custom Analysis Result](https://www.c1.ai/docs/api-reference/role-mining/get-custom-analysis-result.md): GetCustomAnalysisResult returns the status and results of a custom cohort  analysis started with TriggerCustomAnalysis, including entitlement  coverage, entitlement clusters, attribute facets, and cutoff impact  points. Requires the agentic role mining feature.
- [Count Entitlement Selection Filter Attribute Values](https://www.c1.ai/docs/api-reference/role-mining/count-entitlement-selection-filter-attribute-values.md): CountEntitlementSelectionFilterAttributeValues returns exact cohort and  selected-holder counts for one bounded page of custom attribute values.
- [Get Latest Custom Analysis Result](https://www.c1.ai/docs/api-reference/role-mining/get-latest-custom-analysis-result.md): GetLatestCustomAnalysisResult returns the authenticated user's latest  accepted custom analysis result, if one exists.
- [Trigger Custom Analysis](https://www.c1.ai/docs/api-reference/role-mining/trigger-custom-analysis.md): TriggerCustomAnalysis starts an asynchronous custom cohort analysis defined  by the given profile filters and returns the ID of the analysis result.  Requires the agentic role mining feature. Poll GetCustomAnalysisResult  until the analysis completes.
- [List Cohort Filter Attributes](https://www.c1.ai/docs/api-reference/role-mining/list-cohort-filter-attributes.md): ListCohortFilterAttributes is the catalog used by the custom-analysis  editor. It is intentionally independent from value enumeration.
- [List Cohort Filter Attribute Values](https://www.c1.ai/docs/api-reference/role-mining/list-cohort-filter-attribute-values.md): ListCohortFilterAttributeValues pages one attribute's values for the  custom-analysis editor.
- [List Runs](https://www.c1.ai/docs/api-reference/role-mining/list-runs.md): List role mining analysis runs in reverse chronological order.
- [Get Latest Run](https://www.c1.ai/docs/api-reference/role-mining/get-latest-run.md): Retrieve the most recent role mining analysis run, including its status and results summary.
- [List Suggestions](https://www.c1.ai/docs/api-reference/role-mining/list-suggestions.md): List role suggestions generated by analysis runs, optionally filtered by state.
- [Get Suggestion](https://www.c1.ai/docs/api-reference/role-mining/get-suggestion.md): Retrieve a single role suggestion by ID, including its cohort filters, entitlements, and confidence score.
- [Update Suggestion State](https://www.c1.ai/docs/api-reference/role-mining/update-suggestion-state.md): Transition a role suggestion to a new state, such as accepted, rejected, or dismissed.
- [Search Cohort Users](https://www.c1.ai/docs/api-reference/role-mining/search-cohort-users.md): Search for users that belong to a suggestion's cohort, with optional additional profile filters.
- [Trigger Analysis](https://www.c1.ai/docs/api-reference/role-mining/trigger-analysis.md): Start a new role mining analysis job that scans existing access patterns to generate role suggestions.
- [Search](https://www.c1.ai/docs/api-reference/role-mining/search.md): 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.

## OpenAPI Specs

- [my-source-with-code-samples](https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples)