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

# Trigger Custom Analysis

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

TriggerCustomAnalysis starts an asynchronous custom cohort analysis defined
 by the given profile filters and returns the ID of the analysis result.
 Requires the agentic role mining feature. Poll GetCustomAnalysisResult
 until the analysis completes.

## Request body

- C1ApiRoleMiningManagementV1TriggerCustomAnalysisRequest — The TriggerCustomAnalysisRequest message.
  - `profileFilters` C1McpRoleMiningV1ProfileFilter[], nullable — The profileFilters field.
    - `attribute` string — The attribute field.
    - `values` string[], nullable — The values field.

## Response `200`

Successful response

- C1ApiRoleMiningManagementV1TriggerCustomAnalysisResponse — The TriggerCustomAnalysisResponse message.
  - `id` string — The id field.

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking
  - the request property `profileFilters` became not nullable
  - the request property `profileFilters/items/values` became not nullable
- **2026-04-30** `fa2bb307d6fa` — 1 info
  - endpoint added

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