> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-mintlify-0dec08ed.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Evaluate Entitlement Selection

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/role-mining/custom-analysis/{analysis_id}/evaluate-entitlement-selection
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/role-mining/custom-analysis/{analysis_id}/evaluate-entitlement-selection:
    post:
      tags:
        - Role Mining
      summary: Evaluate Entitlement Selection
      description: >-
        Evaluate the exact cohort impact of an entitlement cutoff and manual
        overrides.
         The analysis determines the eligible entitlements and cohort definition.
      operationId: >-
        c1.api.role_mining_management.v1.RoleMiningManagementService.EvaluateEntitlementSelection
      parameters:
        - in: path
          name: analysis_id
          required: true
          schema:
            description: >-
              Custom analysis whose cohort and entitlement results define the
              selection.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.role_mining_management.v1.EvaluateEntitlementSelectionRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.role_mining_management.v1.EvaluateEntitlementSelectionResponse
          description: >-
            EvaluateEntitlementSelectionResponse contains the exact impact of
            the
             resolved entitlement selection.
components:
  schemas:
    c1.api.role_mining_management.v1.EvaluateEntitlementSelectionRequestInput:
      description: >-
        EvaluateEntitlementSelectionRequest selects analyzed entitlements using
        an
         inclusive coverage cutoff plus optional manual overrides.
      properties:
        explicitlyExcluded:
          description: Analyzed entitlements to exclude when they meet the cutoff.
          items:
            $ref: >-
              #/components/schemas/c1.api.role_mining_management.v1.EntitlementRef
          type:
            - array
            - 'null'
        explicitlyIncluded:
          description: >-
            Analyzed entitlements to include even when they fall below the
            cutoff.
          items:
            $ref: >-
              #/components/schemas/c1.api.role_mining_management.v1.EntitlementRef
          type:
            - array
            - 'null'
        includeFacets:
          description: Whether to return profile attribute facets for exact holders.
          type: boolean
        minimumCoverageBasisPoints:
          description: >-
            Inclusive minimum entitlement coverage in basis points, where 8000
            is 80%.
          format: int32
          type: integer
      title: Evaluate Entitlement Selection Request
      type: object
      x-speakeasy-name-override: EvaluateEntitlementSelectionRequest
    c1.api.role_mining_management.v1.EvaluateEntitlementSelectionResponse:
      description: |-
        EvaluateEntitlementSelectionResponse contains the exact impact of the
         resolved entitlement selection.
      properties:
        coreHolderFacets:
          description: >-
            Profile attribute facets narrowed to users who hold every selected
            entitlement.
          items:
            $ref: '#/components/schemas/c1.mcp.role_mining.v1.AttributeFacet'
          type:
            - array
            - 'null'
        selectedEntitlementCount:
          description: Number of entitlements in the resolved selection.
          format: int32
          type: integer
        usersWithAllEntitlements:
          description: Exact number of cohort users who hold every selected entitlement.
          format: int32
          type: integer
      title: Evaluate Entitlement Selection Response
      type: object
      x-speakeasy-name-override: EvaluateEntitlementSelectionResponse
    c1.api.role_mining_management.v1.EntitlementRef:
      description: >-
        EntitlementRef identifies an entitlement by application and entitlement
        ID.
      properties:
        appId:
          description: Application that owns the entitlement.
          type: string
        entitlementId:
          description: Entitlement within the application.
          type: string
      title: Entitlement Ref
      type: object
      x-speakeasy-name-override: EntitlementRef
    c1.mcp.role_mining.v1.AttributeFacet:
      description: >-
        AttributeFacet represents a filterable user profile attribute with its
        available values.
      properties:
        attribute:
          description: The attribute field.
          type: string
        displayName:
          description: The displayName field.
          type: string
        values:
          description: The values field.
          items:
            $ref: '#/components/schemas/c1.mcp.role_mining.v1.AttributeValue'
          type:
            - array
            - 'null'
      title: Attribute Facet
      type: object
      x-speakeasy-name-override: AttributeFacet
    c1.mcp.role_mining.v1.AttributeValue:
      description: AttributeValue represents a single value within a facet.
      properties:
        displayName:
          description: The displayName field.
          type: string
        userCount:
          description: The userCount field.
          format: int32
          type: integer
        value:
          description: The value field.
          type: string
      title: Attribute Value
      type: object
      x-speakeasy-name-override: RoleMiningAttributeValue
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````