> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-hunner-patch-1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Edge Finding Settings

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/findings/settings/edge/update
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/findings/settings/edge/update:
    post:
      tags:
        - Finding Settings
      summary: Update Edge Finding Settings
      description: |-
        Enable or disable detection for one or more Edge finding categories in a
         single write.
      operationId: c1.api.finding.v1.FindingSettingsService.UpdateEdgeFindingSettings
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.finding.v1.UpdateEdgeFindingSettingsRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.finding.v1.UpdateEdgeFindingSettingsResponse
          description: Successful response
components:
  schemas:
    c1.api.finding.v1.UpdateEdgeFindingSettingsRequest:
      description: The UpdateEdgeFindingSettingsRequest message.
      properties:
        settings:
          description: |-
            Applied as one atomic write together with subcategory_settings.
             Categories not listed keep their current state; a category listed twice
             is rejected.
          items:
            $ref: '#/components/schemas/c1.api.finding.v1.EdgeFindingSettingsEntry'
          type:
            - array
            - 'null'
        subcategorySettings:
          description: Same contract as settings, for AI usage subcategories.
          items:
            $ref: >-
              #/components/schemas/c1.api.finding.v1.EdgeFindingSubcategorySettingsEntry
          type:
            - array
            - 'null'
      title: Update Edge Finding Settings Request
      type: object
      x-speakeasy-name-override: UpdateEdgeFindingSettingsRequest
    c1.api.finding.v1.UpdateEdgeFindingSettingsResponse:
      description: The UpdateEdgeFindingSettingsResponse message.
      properties:
        list:
          description: >-
            Every category after the write, in the same shape
            GetEdgeFindingSettings
             returns.
          items:
            $ref: '#/components/schemas/c1.api.finding.v1.EdgeFindingCategorySetting'
          type:
            - array
            - 'null'
        subcategories:
          description: Every AI usage subcategory after the write.
          items:
            $ref: >-
              #/components/schemas/c1.api.finding.v1.EdgeFindingSubcategorySetting
          type:
            - array
            - 'null'
      title: Update Edge Finding Settings Response
      type: object
      x-speakeasy-name-override: UpdateEdgeFindingSettingsResponse
    c1.api.finding.v1.EdgeFindingSettingsEntry:
      description: |-
        EdgeFindingSettingsEntry is a requested change to one category. Separate
         from EdgeFindingCategorySetting for the same reason FindingSettingsEntry is:
         an update needs enum validation and presence on `enabled`.
      properties:
        category:
          description: The category field.
          enum:
            - 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
          type: string
          x-speakeasy-unknown-values: allow
        enabled:
          description: 'Target state. Required: an omitted field must not read as false.'
          type:
            - boolean
            - 'null'
      title: Edge Finding Settings Entry
      type: object
      x-speakeasy-name-override: EdgeFindingSettingsEntry
    c1.api.finding.v1.EdgeFindingSubcategorySettingsEntry:
      description: |-
        EdgeFindingSubcategorySettingsEntry is a requested change to one
         subcategory.
      properties:
        enabled:
          description: 'Target state. Required: an omitted field must not read as false.'
          type:
            - boolean
            - 'null'
        subcategory:
          description: The subcategory field.
          enum:
            - 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
          type: string
          x-speakeasy-unknown-values: allow
      title: Edge Finding Subcategory Settings Entry
      type: object
      x-speakeasy-name-override: EdgeFindingSubcategorySettingsEntry
    c1.api.finding.v1.EdgeFindingCategorySetting:
      description: >-
        EdgeFindingCategorySetting is one Edge finding category's resolved
        switch.
      properties:
        category:
          description: The category field.
          enum:
            - 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
          type: string
          x-speakeasy-unknown-values: allow
        enabled:
          description: Whether rules in this category run.
          type: boolean
      title: Edge Finding Category Setting
      type: object
      x-speakeasy-name-override: EdgeFindingCategorySetting
    c1.api.finding.v1.EdgeFindingSubcategorySetting:
      description: >-
        EdgeFindingSubcategorySetting is one AI usage subcategory's resolved
        switch.
         It only takes effect while EDGE_FINDING_CATEGORY_AI_USAGE is on.
      properties:
        enabled:
          description: Whether rules in this subcategory run when AI usage is on.
          type: boolean
        subcategory:
          description: The subcategory field.
          enum:
            - 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
          type: string
          x-speakeasy-unknown-values: allow
      title: Edge Finding Subcategory Setting
      type: object
      x-speakeasy-name-override: EdgeFindingSubcategorySetting
  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

````