---
title: "PATCH /clinic-settings"
method: PATCH
path: "/clinic-settings"
tags: ["ClinicSettings"]
---

# PATCH /clinic-settings

`PATCH /clinic-settings`

## Request body

- UpdateClinicSettingsRequest
  - `companyName` string, nullable
  - `clinicAddress` string, nullable
  - `clinicPhone` string, nullable
  - `clinicEmail` string, nullable
  - `clinicAboutNotes` string, nullable
  - `defaultAppointmentDurationMinutes` union
    - integer
    - string, int32
  - `schedulingPolicy` string, nullable
  - `timezone` string, nullable
  - `defaultWeeklyHours` LocationHoursEntryDto[], nullable
    - `dayOfWeek` union
      - integer
      - string, int32
    - `openTime` string
    - `closeTime` string
    - `isOpen` boolean
  - `travel` TravelSettingsDto — Travel/mobile appointment settings DTO
    - `travelAppointmentsEnabled` boolean
    - `personalVehicleEnabled` boolean
    - `personalVehicleLocationId` string, nullable
    - `defaultStartingAddress` TravelAddressConfigDto — Address configuration for travel appointments
      - `address` string, nullable
      - `placeId` string, nullable
      - `latitude` union
        - number, double
        - string, double
      - `longitude` union
        - number, double
        - string, double
    - `feeConfig` TravelFeeConfigDto — Fee configuration for travel appointments
      - `calculationMethod` string
      - `baseFee` union
        - number, double
        - string, double
      - `perMileRate` union
        - number, double
        - string, double
      - `flatRateAmount` union
        - number, double
        - string, double
      - `tiers` TravelFeeTierDto[]
        - `maxDistanceMiles` union
          - integer
          - string, int32
        - `feeAmount` union
          - number, double
          - string, double
    - `defaultRoundTrip` boolean
    - `maxDistanceMiles` union
      - integer
      - string, int32
  - `schedulingPreferences` SchedulingPreferencesDto — Scheduling preferences — room management, default views, etc.
    - `roomManagementEnabled` boolean
    - `unassignedLocationId` string, nullable
  - `metrics` MetricsSettingsDto — Tunable thresholds for the BI / DVM Production reports. Currently exposes the "high compensation" warning trigger; additional thresholds (low rev/hr, leakage) will hang here as they get pulled out of hardcoded service code.
    - `compensationThresholdPercent` union — Comp-percent threshold above which a provider's status flips to "warning". Default 35. Per-vet override available on `VeterinarianCompensation`.
      - number, double
      - string, double

## Response `200`

OK

- ClinicSettingsDto
  - `companyId` string
  - `companyName` string
  - `clinicAddress` string, nullable
  - `clinicPhone` string, nullable
  - `clinicEmail` string, nullable
  - `clinicAboutNotes` string, nullable
  - `defaultAppointmentDurationMinutes` union
    - integer
    - string, int32
  - `schedulingPolicy` string
  - `timezone` string — The clinic's IANA zone. Never null — server-side formatters (email, SMS, voice, PDFs, labels) have no sane way to degrade and must not fall through to UTC, so an unconfigured tenant reads back as Eastern. Check bool ClinicSettingsDto.TimezoneConfigured before trusting it as the clinic's actual location.
  - `timezoneConfigured` boolean — False when the tenant has no stored timezone and string ClinicSettingsDto.Timezone is therefore the Eastern placeholder rather than a real setting. The web app uses this to prefer the workstation's own zone: rendering a Pacific clinic's day in Eastern is what produced ITE-337.
  - `defaultWeeklyHours` LocationHoursEntryDto[], nullable
    - `dayOfWeek` union
      - integer
      - string, int32
    - `openTime` string
    - `closeTime` string
    - `isOpen` boolean
  - `travel` TravelSettingsDto — Travel/mobile appointment settings DTO
    - `travelAppointmentsEnabled` boolean
    - `personalVehicleEnabled` boolean
    - `personalVehicleLocationId` string, nullable
    - `defaultStartingAddress` TravelAddressConfigDto — Address configuration for travel appointments
      - `address` string, nullable
      - `placeId` string, nullable
      - `latitude` union
        - number, double
        - string, double
      - `longitude` union
        - number, double
        - string, double
    - `feeConfig` TravelFeeConfigDto — Fee configuration for travel appointments
      - `calculationMethod` string
      - `baseFee` union
        - number, double
        - string, double
      - `perMileRate` union
        - number, double
        - string, double
      - `flatRateAmount` union
        - number, double
        - string, double
      - `tiers` TravelFeeTierDto[]
        - `maxDistanceMiles` union
          - integer
          - string, int32
        - `feeAmount` union
          - number, double
          - string, double
    - `defaultRoundTrip` boolean
    - `maxDistanceMiles` union
      - integer
      - string, int32
  - `schedulingPreferences` SchedulingPreferencesDto — Scheduling preferences — room management, default views, etc.
    - `roomManagementEnabled` boolean
    - `unassignedLocationId` string, nullable
  - `metrics` MetricsSettingsDto — Tunable thresholds for the BI / DVM Production reports. Currently exposes the "high compensation" warning trigger; additional thresholds (low rev/hr, leakage) will hang here as they get pulled out of hardcoded service code.
    - `compensationThresholdPercent` union — Comp-percent threshold above which a provider's status flips to "warning". Default 35. Per-vet override available on `VeterinarianCompensation`.
      - number, double
      - string, double
  - `billingStatus` string, nullable — Billing/contract state: "Trial", "Active", "Suspended", or empty for legacy records (treated as "Active"). Drives GDPR consent banner visibility post-login.

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/versions/a905bde4e796/schema)