> ## Documentation Index > Fetch the complete documentation index at: https://conductorone-luisinasantos-sync-coupa-v0-1-13-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Trigger Custom Analysis > 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. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/role-mining/custom-analysis/trigger openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/role-mining/custom-analysis/trigger: post: tags: - Role Mining summary: Trigger Custom Analysis description: >- 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. operationId: >- c1.api.role_mining_management.v1.RoleMiningManagementService.TriggerCustomAnalysis requestBody: content: application/json: schema: $ref: >- #/components/schemas/c1.api.role_mining_management.v1.TriggerCustomAnalysisRequest responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.role_mining_management.v1.TriggerCustomAnalysisResponse description: Successful response x-codeSamples: - lang: go label: TriggerCustomAnalysis source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := conductoronesdkgo.New(\n conductoronesdkgo.WithSecurity(shared.Security{\n BearerAuth: \"\",\n Oauth: \"\",\n }),\n )\n\n res, err := s.RoleMiningManagement.TriggerCustomAnalysis(ctx, nil)\n if err != nil {\n log.Fatal(err)\n }\n if res.TriggerCustomAnalysisResponse != nil {\n // handle response\n }\n}" - lang: typescript label: Typescript (SDK) source: >- import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript"; const conductoroneSDKTypescript = new ConductoroneSDKTypescript({ security: { bearerAuth: "", oauth: "", }, }); async function run() { const result = await conductoroneSDKTypescript.roleMiningManagement.triggerCustomAnalysis(); console.log(result); } run(); components: schemas: c1.api.role_mining_management.v1.TriggerCustomAnalysisRequest: description: The TriggerCustomAnalysisRequest message. properties: accessScope: oneOf: - $ref: '#/components/schemas/c1.mcp.role_mining.v1.AccessScope' - type: 'null' profileFilters: description: The profileFilters field. items: $ref: '#/components/schemas/c1.mcp.role_mining.v1.ProfileFilter' type: - array - 'null' resourceScope: oneOf: - $ref: '#/components/schemas/c1.mcp.role_mining.v1.ResourceScope' - type: 'null' title: Trigger Custom Analysis Request type: object x-speakeasy-name-override: TriggerCustomAnalysisRequest c1.api.role_mining_management.v1.TriggerCustomAnalysisResponse: description: The TriggerCustomAnalysisResponse message. properties: id: description: The id field. type: string title: Trigger Custom Analysis Response type: object x-speakeasy-name-override: TriggerCustomAnalysisResponse c1.mcp.role_mining.v1.AccessScope: description: > AccessScope narrows a cohort to the users who hold a grant. It is combined with any ProfileFilters using AND logic, and is a complete cohort definition on its own. This message contains a oneof named scope. Only a single field of the following list may be set at a time: - appId - entitlement properties: appId: description: >- Cohort is every user holding a grant to this app's built-in Access entitlement, which is how "everyone with access to the app" is stored. This field is part of the `scope` oneof. See the documentation for `c1.mcp.role_mining.v1.AccessScope` for more details. type: - string - 'null' entitlement: oneOf: - $ref: >- #/components/schemas/c1.mcp.role_mining.v1.AppEntitlementScopeRef - type: 'null' title: Access Scope type: object x-speakeasy-name-override: AccessScope c1.mcp.role_mining.v1.ProfileFilter: description: |- ProfileFilter defines a filter on a user profile attribute. Use GetOrgOverview to discover available attribute keys and their values. properties: attribute: description: The attribute field. type: string values: description: The values field. items: type: string type: - array - 'null' title: Profile Filter type: object x-speakeasy-name-override: ProfileFilter c1.mcp.role_mining.v1.ResourceScope: description: |- ResourceScope narrows which entitlements an analysis considers, without changing the cohort. Coverage denominators stay the population the ProfileFilters and AccessScope select; only the entitlement universe shrinks. It is never a cohort definition on its own. properties: appIds: description: The appIds field. items: type: string type: - array - 'null' title: Resource Scope type: object x-speakeasy-name-override: ResourceScope c1.mcp.role_mining.v1.AppEntitlementScopeRef: description: >- AppEntitlementScopeRef identifies one entitlement by app and entitlement ID. properties: appId: description: The appId field. type: string entitlementId: description: The entitlementId field. type: string title: App Entitlement Scope Ref type: object x-speakeasy-name-override: AppEntitlementScopeRef securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````