---
title: "Get Suggestion"
method: GET
path: "/api/v1/role-mining/suggestions/{id}"
tags: ["Role Mining"]
---

# Get Suggestion

`GET /api/v1/role-mining/suggestions/{id}`

Retrieve a single role suggestion by ID, including its cohort filters, entitlements, and confidence score.

## Path parameters

- `id` string, required — The ID of the role mining suggestion to retrieve.

## Response `200`

Successful response

- C1ApiRoleMiningManagementV1GetSuggestionResponse — The GetSuggestionResponse message.
  - `suggestion` C1ApiRoleMiningManagementV1RoleMiningManagementSuggestion — The RoleMiningManagementSuggestion message.
    - `avgCoverage` number — Average fraction of suggested entitlements held by each user in the cohort.
    - `cohortFilters` C1McpRoleMiningV1ProfileFilter[], nullable — The profile filters that define which users belong to this cohort.
      - `attribute` string — The attribute field.
      - `values` string[], nullable — The values field.
    - `cohortSize` integer — Total number of users in the cohort matching the profile filters.
    - `confidence` number — Overall confidence score for this suggestion, from 0.0 to 1.0.
    - `createdAt` string, date-time
    - `createdCatalogId` string — The ID of the access profile created when this suggestion was accepted, empty if not yet accepted.
    - `description` string — A human-readable description of the proposed role and the cohort it serves.
    - `dimensionCount` integer — Number of distinct attribute dimensions used to define the cohort.
    - `entitlements` C1McpRoleMiningV1CohortEntitlement[], nullable — The entitlements that are commonly held by users in this cohort.
      - `appDisplayName` string — The appDisplayName field.
      - `appId` string — The appId field.
      - `appResourceDisplayName` string — The appResourceDisplayName field.
      - `appResourceTypeDisplayName` string — The appResourceTypeDisplayName field.
      - `coverage` number — The coverage field.
      - `entitlementDisplayName` string — The entitlementDisplayName field.
      - `entitlementId` string — The entitlementId field.
      - `grantedCount` integer — The grantedCount field.
      - `riskLevelValueId` string — The riskLevelValueId field.
    - `existingProfileMatches` C1McpRoleMiningV1AccessProfileMatch[], nullable — Existing access profiles that overlap with this suggestion.
      - `catalogDisplayName` string — The catalogDisplayName field.
      - `catalogId` string — The catalogId field.
      - `matchType` 'ACCESS_PROFILE_MATCH_TYPE_UNSPECIFIED' | 'ACCESS_PROFILE_MATCH_TYPE_EXACT' | 'ACCESS_PROFILE_MATCH_TYPE_SUPERSET' | 'ACCESS_PROFILE_MATCH_TYPE_PARTIAL' — The matchType field.
      - `missingEntitlements` C1McpRoleMiningV1CohortEntitlement[], nullable — The missingEntitlements field.
        - `appDisplayName` string — The appDisplayName field.
        - `appId` string — The appId field.
        - `appResourceDisplayName` string — The appResourceDisplayName field.
        - `appResourceTypeDisplayName` string — The appResourceTypeDisplayName field.
        - `coverage` number — The coverage field.
        - `entitlementDisplayName` string — The entitlementDisplayName field.
        - `entitlementId` string — The entitlementId field.
        - `grantedCount` integer — The grantedCount field.
        - `riskLevelValueId` string — The riskLevelValueId field.
      - `overlapRatio` number — The overlapRatio field.
    - `id` string — Unique identifier for this suggestion.
    - `insights` string[], nullable — Human-readable insights explaining why this role was suggested.
    - `lastGeneratedAt` string, date-time
    - `runId` string — The ID of the analysis run that produced this suggestion.
    - `suggestedName` string — The suggested display name for the proposed role.
    - `suggestionState` 'SUGGESTION_STATE_UNSPECIFIED' | 'SUGGESTION_STATE_NEW' | 'SUGGESTION_STATE_DISMISSED' | 'SUGGESTION_STATE_ACCEPTED' — Current workflow state of this suggestion (e.g., pending, accepted, dismissed).
    - `updatedAt` string, date-time
    - `usersWithAll` integer — Number of users in the cohort that hold all of the suggested entitlements.

---

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