---
title: "List Runs"
method: GET
path: "/api/v1/role-mining/runs"
tags: ["Role Mining"]
---

# List Runs

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

List role mining analysis runs in reverse chronological order.

## Response `200`

Successful response

- C1ApiRoleMiningManagementV1ListRunsResponse — The ListRunsResponse message.
  - `list` C1ApiRoleMiningManagementV1RoleMiningManagementRun[], nullable — The list of role mining analysis runs.
    - `cohortsAnalyzed` integer — Number of user cohorts evaluated during the analysis.
    - `completedAt` string, date-time
    - `createdAt` string, date-time
    - `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
  - `nextPageToken` string — Token to retrieve the next page of results, empty if no more results.

---

[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)