---
title: "Evaluate Entitlement Selection"
method: POST
path: "/api/v1/role-mining/custom-analysis/{analysis_id}/evaluate-entitlement-selection"
tags: ["Role Mining"]
---

# Evaluate Entitlement Selection

`POST /api/v1/role-mining/custom-analysis/{analysis_id}/evaluate-entitlement-selection`

Evaluate the exact cohort impact of an entitlement cutoff and manual overrides.
 The analysis determines the eligible entitlements and cohort definition.

## Path parameters

- `analysis_id` string, required — Custom analysis whose cohort and entitlement results define the selection.

## Request body

- C1ApiRoleMiningManagementV1EvaluateEntitlementSelectionRequestInput — EvaluateEntitlementSelectionRequest selects analyzed entitlements using an inclusive coverage cutoff plus optional manual overrides.
  - `explicitlyExcluded` C1ApiRoleMiningManagementV1EntitlementRef[], nullable — Analyzed entitlements to exclude when they meet the cutoff.
    - `appId` string — Application that owns the entitlement.
    - `entitlementId` string — Entitlement within the application.
  - `explicitlyIncluded` C1ApiRoleMiningManagementV1EntitlementRef[], nullable — Analyzed entitlements to include even when they fall below the cutoff.
    - `appId` string — Application that owns the entitlement.
    - `entitlementId` string — Entitlement within the application.
  - `includeFacets` boolean — Whether to return profile attribute facets for exact holders.
  - `minimumCoverageBasisPoints` integer — Inclusive minimum entitlement coverage in basis points, where 8000 is 80%.

## Response `200`

EvaluateEntitlementSelectionResponse contains the exact impact of the
 resolved entitlement selection.

- C1ApiRoleMiningManagementV1EvaluateEntitlementSelectionResponse — EvaluateEntitlementSelectionResponse contains the exact impact of the resolved entitlement selection.
  - `coreHolderFacets` C1McpRoleMiningV1AttributeFacet[], nullable — Profile attribute facets narrowed to users who hold every selected entitlement.
    - `attribute` string — The attribute field.
    - `displayName` string — The displayName field.
    - `values` C1McpRoleMiningV1AttributeValue[], nullable — The values field.
      - `displayName` string — The displayName field.
      - `userCount` integer — The userCount field.
      - `value` string — The value field.
  - `selectedEntitlementCount` integer — Number of entitlements in the resolved selection.
  - `usersWithAllEntitlements` integer — Exact number of cohort users who hold every selected entitlement.

## Changes

- **2026-09-01** `f76d07868c0c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/role-mining/custom-analysis/:analysis_id/evaluate-entitlement-selection/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f76d07868c0c/schema)