---
title: "Trigger Analysis"
method: POST
path: "/api/v1/role-mining/trigger"
tags: ["Role Mining"]
---

# Trigger Analysis

`POST /api/v1/role-mining/trigger`

Start a new role mining analysis job that scans existing access patterns to generate role suggestions.

## Request body

- C1ApiRoleMiningManagementV1TriggerAnalysisRequest — The TriggerAnalysisRequest message.

## Response `200`

Successful response

- C1ApiRoleMiningManagementV1TriggerAnalysisResponse — The TriggerAnalysisResponse message.
  - `runId` string — The ID of the newly created analysis run.

## Changes

- **2026-03-18** `8a0bdc21dd5f` — 1 info
  - endpoint added

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