> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veridox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Verification Setting

> Switch verification checks on or off for your organisation's analyses.

Switches verification checks on or off for your organisation's analyses. Send `{ "enabled": true }` or `{ "enabled": false }`; the response returns the saved value. A body with a missing or non-boolean `enabled`, or any other field, is rejected with `400`.

<Note>
  This endpoint requires the verification feature to be enabled for your organisation. Without it, the API returns `403` with `request.organisations.feature-flag.not-enabled`. [Learn more](/guides/feature-modules).
</Note>

## Permission

Requires `organisation_settings:write`, which the Owner role holds by default. A caller without it receives `403`.

## What Changes

* **Later analyses only.** The setting applies to analyses that run after you change it. Existing results are not rerun or altered.
* **Cached results are cleared.** Changing the value clears your organisation's cached analysis results, so a file uploaded again afterwards is analysed afresh rather than returning an earlier result. Saving the value it already has clears nothing.

## Related

* [Get Verification Setting](./org-verification-get) reads the current value.
* [Get File Analysis](./files-analysis-get#verification-evidence) describes the evidence the setting controls.


## OpenAPI

````yaml PUT /organisations/features/verification
openapi: 3.1.0
info:
  title: Veridox Core API
  description: Veridox Core Platform API
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.uk.veridox.ai
    description: Live (UK)
  - url: https://api.ca.veridox.ai
    description: Live (CA)
security: []
tags:
  - name: Status
    description: System status and health check endpoints
  - name: Cases
    description: Case and case file management
  - name: Organisations
    description: Organisation management
  - name: Document Requests
    description: Document request management
  - name: Search
    description: Search functionality
  - name: Admin
    description: Administrative endpoints
paths:
  /organisations/features/verification:
    put:
      tags:
        - Organisations
      summary: Update verification settings
      description: >-
        Switches verification checks on or off for the organisation's analyses.
        Writes an audit-log entry. Requires organisation_settings:write and the
        verification feature.
      operationId: VerificationSettingsController_updateSettings
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateVerificationSettingsRequestDto'
      responses:
        '200':
          description: Verification settings updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationSettingsResponseDto'
        '400':
          description: Missing or non-boolean enabled, or an unknown field
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '401':
          description: Unauthorized (invalid or missing authentication token)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '403':
          description: >-
            Caller lacks organisation_settings:write, or the feature is not
            enabled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '429':
          description: Too many requests (rate limit exceeded)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      security:
        - api-key: []
components:
  schemas:
    UpdateVerificationSettingsRequestDto:
      type: object
      properties:
        enabled:
          type: boolean
          x-nestjs_zod-parent-additional-properties: false
          x-nestjs_zod-parent-metadata:
            description: Request payload for updating verification settings
      required:
        - enabled
    VerificationSettingsResponseDto:
      type: object
      properties:
        enabled:
          type: boolean
      required:
        - enabled
    ErrorDto:
      type: object
      properties:
        error_code:
          type: string
          description: Machine-readable error code for programmatic handling
          examples:
            - request.cases.file.missing-risk-score
            - request.authentication.invalid-token
            - request.forbidden
            - request.cases.case.not-found
            - request.cases.case.already-locked
        error_message:
          type: string
          description: Human-readable error message explaining what went wrong
          example: >-
            User tried to perform an invalid operation on a file without a risk
            score.
        error_details:
          type: object
          example:
            field: email_address
      required:
        - error_code
        - error_message
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.