---
title: "Update Edge Finding Settings"
method: POST
path: "/api/v1/findings/settings/edge/update"
tags: ["Finding Settings"]
---

# Update Edge Finding Settings

`POST /api/v1/findings/settings/edge/update`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/findings/settings/edge/update`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Enable or disable detection for one or more Edge finding categories in a
 single write.

## Request body

- C1ApiFindingV1UpdateEdgeFindingSettingsRequest: The UpdateEdgeFindingSettingsRequest message.
  - `settings` C1ApiFindingV1EdgeFindingSettingsEntry[], nullable: Applied as one atomic write together with subcategory_settings. Categories not listed keep their current state; a category listed twice is rejected.
    - `category` 'EDGE_FINDING_CATEGORY_UNSPECIFIED' | 'EDGE_FINDING_CATEGORY_DESTINATION_RISK' | 'EDGE_FINDING_CATEGORY_POLICY_HEALTH' | 'EDGE_FINDING_CATEGORY_DATA_VOLUME' | 'EDGE_FINDING_CATEGORY_IDENTITY' | 'EDGE_FINDING_CATEGORY_AI_USAGE' | 'EDGE_FINDING_CATEGORY_TRANSPORT' | 'EDGE_FINDING_CATEGORY_BEHAVIOR' | 'EDGE_FINDING_CATEGORY_EDGE_HEALTH': The category field.
    - `enabled` boolean, nullable: Target state. Required: an omitted field must not read as false.
  - `subcategorySettings` C1ApiFindingV1EdgeFindingSubcategorySettingsEntry[], nullable: Same contract as settings, for AI usage subcategories.
    - `enabled` boolean, nullable: Target state. Required: an omitted field must not read as false.
    - `subcategory` 'EDGE_FINDING_SUBCATEGORY_UNSPECIFIED' | 'EDGE_FINDING_SUBCATEGORY_AI_MODEL_GOVERNANCE' | 'EDGE_FINDING_SUBCATEGORY_AI_USAGE_COST' | 'EDGE_FINDING_SUBCATEGORY_AI_ATTRIBUTION' | 'EDGE_FINDING_SUBCATEGORY_AI_RELIABILITY': The subcategory field.

## Response `200`

Successful response

- C1ApiFindingV1UpdateEdgeFindingSettingsResponse: The UpdateEdgeFindingSettingsResponse message.
  - `list` C1ApiFindingV1EdgeFindingCategorySetting[], nullable: Every category after the write, in the same shape GetEdgeFindingSettings returns.
    - `category` 'EDGE_FINDING_CATEGORY_UNSPECIFIED' | 'EDGE_FINDING_CATEGORY_DESTINATION_RISK' | 'EDGE_FINDING_CATEGORY_POLICY_HEALTH' | 'EDGE_FINDING_CATEGORY_DATA_VOLUME' | 'EDGE_FINDING_CATEGORY_IDENTITY' | 'EDGE_FINDING_CATEGORY_AI_USAGE' | 'EDGE_FINDING_CATEGORY_TRANSPORT' | 'EDGE_FINDING_CATEGORY_BEHAVIOR' | 'EDGE_FINDING_CATEGORY_EDGE_HEALTH': The category field.
    - `enabled` boolean: Whether rules in this category run.
  - `subcategories` C1ApiFindingV1EdgeFindingSubcategorySetting[], nullable: Every AI usage subcategory after the write.
    - `enabled` boolean: Whether rules in this subcategory run when AI usage is on.
    - `subcategory` 'EDGE_FINDING_SUBCATEGORY_UNSPECIFIED' | 'EDGE_FINDING_SUBCATEGORY_AI_MODEL_GOVERNANCE' | 'EDGE_FINDING_SUBCATEGORY_AI_USAGE_COST' | 'EDGE_FINDING_SUBCATEGORY_AI_ATTRIBUTION' | 'EDGE_FINDING_SUBCATEGORY_AI_RELIABILITY': The subcategory field.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/findings/settings/edge/update/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.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)