Need help in removing colorOverride in the appointment!

[forest146]

The documentation (https://www.opendental.com/site/apiappointments.html) very clearly mentions this:
```colorOverride: (Added in version 22.3.9) Comma delimited list of three color values from 0-255. Use 0 to clear colorOverride.
```
When I am sending `0`

Code: Select all

2026-07-15 21:57:17,133 WARNING common.integrations.opendental: OD PUT /appointments/9319323 failed: HTTP 400
2026-07-15 21:57:17,133 WARNING services.api.routers.breakdowns: OpenDental appointment color write failed (appointment=1025 eligibility='Active')
Traceback (most recent call last):
  File "api/routers/breakdowns.py", line 1791, in _sync_opendental_appointment_color
    before, after, changed = _retry_opendental_side_effect(
                             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "api/routers/breakdowns.py", line 1576, in _retry_opendental_side_effect
    return fn()
           ^^^^
  File "api/routers/breakdowns.py", line 1793, in <lambda>
    lambda: set_appointment_color_override(integration.clinic_name, apt_num, color_override),
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "common/integrations/opendental.py", line 443, in set_appointment_color_override
    od_put(dev_key, cust_key, f"/appointments/{apt_num_text}", {"colorOverride": color_override})
  File "common/integrations/opendental.py", line 375, in od_put
    _raise_for_status("PUT", path, resp)
  File "common/integrations/opendental.py", line 337, in _raise_for_status
    raise OpenDentalAPIError(method, path, resp.status_code, resp.text)
common.integrations.opendental.OpenDentalAPIError: OpenDental PUT /appointments/9319323 failed: HTTP 400 "ColorOverride is invalid. Must be a color in R,G,B format."

Please need help here! How do I clear out any colorOverride of an appointment?

[AustinD]

Hello forest146,

ColorOverride was added in version 22.3.9, but the ability to clear colorOverride by sending 0 was added later, in version 25.4.32. The request is likely failing because the office is on a lower version. If this is the case, the office will need to update in order for the colorOverride field to be set to 0.

Thank you.

[forest146]

Hi AustinD,

Thanks for such a speedy and helpful reply!