> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/calendar/schedules-v3/introduction.md

## Article Content:

# About the Schedules API

The Schedules API allows you to manage collections of
[events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md).
Schedules allow you to easily manage events that are linked to the same entity, such as a
[Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object.md)
or [Bookings resource](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resources-v2/resource-object.md).
You can also create schedules for custom entities beyond the Wix ecosystem.
Schedules set [default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values.md)
for their events, ensuring consistency across all related events.

With the Schedules API, you can:

+ Create and update schedules.
+ Retrieve schedules.
+ Cancel schedules permanently.
+ Track in real-time when a schedule is created or modified.

For more in-depth scheduling management, see:

+ [Events API](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md)
+ [Schedule Time Frames API](https://dev.wix.com/docs/rest/business-management/calendar/schedule-time-frames-v3/introduction.md)
+ [Bookings APIs](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings.md)

## Before You Begin

It’s important to note the following points before starting to code:

+ The schedule object itself doesn’t store event details. Each event is independently managed.
+ An event must belong to exactly one schedule.
+ Once a schedule is marked as `CANCELLED`, you can't reactivate, update, or associate it with new events.
+ Recurring events aren't defined by the schedule itself. Instead, create a `MASTER` event to establish the recurrence pattern.

## Use cases

+ [Manage a calendar](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#manage-a-calendar)
+ [Sync Wix calendars to an external system](https://dev.wix.com/docs/rest/business-management/calendar/sample-flows.md#sync-wix-calendars-to-an-external-system)

## Terminology

+ __Schedule__: Collection of [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md) associated with a specific entity, such as a [Bookings service](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/service-object.md), or [Bookings resource](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resources-v2/resource-object.md). Schedules also serve as templates for the events they manage, setting default values like a default location.
+ __Status__: Indicates whether a schedule can be updated or if it’s permanently `CANCELLED`.
+ __Role__: You can assign roles to [Wix users](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities.md#wix-users)
giving them specific access to the schedule.
  + __Writer__: Can read and modify the schedule.
  + __Commenter__: Can only read the schedule.
+ __Schedule time frame__: Defines the first and last event dates within a schedule and indicates whether any events recur indefinitely.
+ __Event__: A calendar entry that specifies details such as timing, location, and participants. Each event is associated with a schedule and may inherit its [default values](https://dev.wix.com/docs/rest/business-management/calendar/default-values.md). Events can be standalone or part of a recurring series and can block time or allow concurrent scheduling on the calendar.

@sdk_package_setup