---
title: "Get Latest Run"
method: GET
path: "/api/v1/role-mining/runs/latest"
tags: ["Role Mining"]
---

# Get Latest Run

`GET /api/v1/role-mining/runs/latest`

Retrieve the most recent role mining analysis run, including its status and results summary.

## Response `200`

Successful response

- C1ApiRoleMiningManagementV1GetLatestRunResponse — The GetLatestRunResponse message.
  - `run` C1ApiRoleMiningManagementV1RoleMiningManagementRun — The RoleMiningManagementRun message.
    - `cohortsAnalyzed` integer — Number of user cohorts evaluated during the analysis.
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `errorMessage` string — Error message if the run failed, empty on success.
    - `id` string — Unique identifier for this analysis run.
    - `status` 'RUN_STATUS_UNSPECIFIED' | 'RUN_STATUS_RUNNING' | 'RUN_STATUS_COMPLETED' | 'RUN_STATUS_FAILED' — Current execution status of this run (e.g., running, completed, failed).
    - `suggestionsGenerated` integer — Number of role suggestions produced by this run.
    - `totalUsers` integer — Total number of users evaluated during the analysis.
    - `triggerDetail` string — Additional detail about the trigger, such as the user or schedule that initiated the run.
    - `triggerType` 'TRIGGER_TYPE_UNSPECIFIED' | 'TRIGGER_TYPE_MANUAL' | 'TRIGGER_TYPE_UPLIFT_COMPLETION' | 'TRIGGER_TYPE_SCHEDULED' | 'TRIGGER_TYPE_DIRECTORY_MERGE' — How this run was initiated (e.g., manual, scheduled).
    - `updatedAt` string, date-time, nullable

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking, 11 warning
  - added `#/components/schemas/c1.api.role_mining_management.v1.RoleMiningManagementRun, subschema #2` to the `run` response property `oneOf` list for the response status `200`
  - the `run` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `run/cohortsAnalyzed` from the response with the `200` status
  - removed the optional property `run/completedAt` from the response with the `200` status
  - …9 more
- **2026-04-30** `fa2bb307d6fa` — 1 warning
  - added the new `TRIGGER_TYPE_DIRECTORY_MERGE` enum value to the `run/triggerType` response property for the response status `200`
- **2026-03-18** `8a0bdc21dd5f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/role-mining/runs/latest/get.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/f2cf3228f366/schema)