---
title: "Partially update a schedule block"
method: PATCH
path: "/api/schedule_blocks/{id}"
tags: ["Clinical"]
---

# Partially update a schedule block

`PATCH /api/schedule_blocks/{id}`

Partially update an existing schedule block. You can modify the time, description, color, or other properties. Use this to reschedule a block or change its details.

## Path parameters

- `id` string, required

## Request body

- ScheduleBlock — Schedule blocks are used to block off time on a provider's calendar, preventing appointments from being scheduled during those times. They can be associated with a specific provider, office, and exam room. Common use cases include blocking time for lunch breaks, meetings, administrative tasks, PTO, or other non-appointment activities.
  - `description` string — Description or reason for the schedule block (e.g., "Lunch Break", "Staff Meeting", "PTO")
  - `office` integer, required — ID of the office where the schedule block is applied
  - `color` string — Custom color associated with the schedule block for calendar display
  - `practice_group` integer — ID of the practice group for the associated provider (doctor)
  - `start_time` string, date-time, required — Start time of the schedule block in ISO 8601 format
  - `exam_room` integer — ID of the exam room where the schedule block is applied
  - `series` integer — Series ID if the schedule block is part of a recurring series
  - `end_time` string, date-time, required — End time of the schedule block in ISO 8601 format
  - `provider` integer, required — ID of the provider or doctor who owns this schedule block
  - `id` integer — Unique identifier for the schedule block
  - `appointment_break` integer — ID of an associated appointment break, if applicable

## Response `200`

OK - Schedule block updated

- ScheduleBlock — Schedule blocks are used to block off time on a provider's calendar, preventing appointments from being scheduled during those times. They can be associated with a specific provider, office, and exam room. Common use cases include blocking time for lunch breaks, meetings, administrative tasks, PTO, or other non-appointment activities.
  - `description` string — Description or reason for the schedule block (e.g., "Lunch Break", "Staff Meeting", "PTO")
  - `office` integer, required — ID of the office where the schedule block is applied
  - `color` string — Custom color associated with the schedule block for calendar display
  - `practice_group` integer — ID of the practice group for the associated provider (doctor)
  - `start_time` string, date-time, required — Start time of the schedule block in ISO 8601 format
  - `exam_room` integer — ID of the exam room where the schedule block is applied
  - `series` integer — Series ID if the schedule block is part of a recurring series
  - `end_time` string, date-time, required — End time of the schedule block in ISO 8601 format
  - `provider` integer, required — ID of the provider or doctor who owns this schedule block
  - `id` integer — Unique identifier for the schedule block
  - `appointment_break` integer — ID of an associated appointment break, if applicable

## Other responses

- `204` — No Content - Schedule block updated (alternative response)
- `400` — Bad Request - Invalid data
- `401` — Unauthorized
- `403` — Permission Denied
- `404` — Not Found
- `500` — Internal Server Error

---

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