---
title: "Replace availability rules and/or date overrides for a schedule"
method: PATCH
path: "/appointments/schedules/{schedule_id}/availability"
tags: ["Appointments"]
---

# Replace availability rules and/or date overrides for a schedule

`PATCH /appointments/schedules/{schedule_id}/availability`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/schedules/{schedule_id}/availability`
- Auth: HTTP bearer

Replace weekly availability rules and/or date overrides for a schedule.

Body: ``{"availability": [...], "overrides": [...]}``

- ``availability``: list of ``{days, start_time, end_time}`` - replaces ALL weekly rules.
- ``overrides``: list of ``{date, start_time, end_time}`` - replaces ALL date overrides.

Omit a key to leave that set unchanged. At least one key is required.
Mirrors the in-app ``PATCH /schedules/{id}/availability`` logic verbatim.
Typed via ``UpdateAvailabilityRequest`` so malformed items fail at FastAPI
validation (422) rather than as an opaque 500.

## Path parameters

- `schedule_id` integer, required: Schedule integer ID.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- UpdateAvailabilityRequest
  - `availability` AvailabilityInput[], nullable
    - `days` integer[], required
    - `start_time` string, required
    - `end_time` string, required
  - `overrides` OverrideInput[], nullable
    - `date` string, required
    - `start_time` string, required
    - `end_time` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)