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

# Update Settings

> Update your organisation's configuration settings.

## Path Parameters

<ParamField path="orgId" type="string" required>
  Your organisation's unique identifier.
</ParamField>

## Request Body

<ParamField body="org_id" type="integer">
  The associated organisation's ID. Must match the `orgId` path parameter.
</ParamField>

<ParamField body="settings" type="object">
  A JSON object containing the settings fields to update. Currently supported settings:

  * `alert_on_failure` (boolean) — When `true`, Voxmind sends a notification to your organisation's contact email when a verification failure rate exceeds normal thresholds. Useful for detecting coordinated attack patterns or integration issues in production.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.voxmind.ai/organisations/42/settings \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "org_id": 42,
      "settings": {
        "alert_on_failure": true
      }
    }'
  ```

  ```python Python theme={null}
  resp = requests.patch(
      "https://api.voxmind.ai/organisations/42/settings",
      headers={"Authorization": "Bearer YOUR_API_TOKEN"},
      json={"org_id": 42, "settings": {"alert_on_failure": True}},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": 1,
    "org_id": 42,
    "settings": {
      "alert_on_failure": true
    },
    "created_at": "2025-01-15T09:00:00Z",
    "updated_at": "2025-03-15T11:30:00Z"
  }
  ```
</ResponseExample>