# Calendar

HTML: https://www.app2email.com/docs/api/calendar · Index: https://www.app2email.com/docs/api/llms.txt

The business calendar: appointments, blocked time, internal notes, links to the online booking page and held times. Services, staff and the next free times for agents.

| Method | Path | Summary | Scope | Sandbox key |
| --- | --- | --- | --- | --- |
| PATCH | `/v1/{number}/bookings/{id}` | [Change an appointment's details](https://www.app2email.com/docs/api/calendar/update-booking.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/calendar` | [Everything on the calendar for a range of days](https://www.app2email.com/docs/api/calendar/get-calendar.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/calendar/blocks` | [The blocked times](https://www.app2email.com/docs/api/calendar/list-calendar-blocks.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/calendar/blocks` | [Block time so that no one can book it](https://www.app2email.com/docs/api/calendar/create-calendar-block.md) | `bookings:manage` | refused |
| PATCH | `/v1/{number}/calendar/blocks/{id}` | [Change a blocked time](https://www.app2email.com/docs/api/calendar/update-calendar-block.md) | `bookings:manage` | refused |
| DELETE | `/v1/{number}/calendar/blocks/{id}` | [Remove a blocked time](https://www.app2email.com/docs/api/calendar/delete-calendar-block.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/services` | [The services a customer can book, and their staff](https://www.app2email.com/docs/api/calendar/list-bookable-services.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/bookings/staff` | [The staff members and the services they do](https://www.app2email.com/docs/api/calendar/list-booking-staff.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/bookings/next` | [The next free start times for a service, across days](https://www.app2email.com/docs/api/calendar/get-next-booking-slots.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/{id}/reschedule` | [Move an appointment to another time](https://www.app2email.com/docs/api/calendar/reschedule-booking.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/{id}/notes` | [The internal notes of an appointment and its customer](https://www.app2email.com/docs/api/calendar/list-booking-notes.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/{id}/notes` | [Add an internal note to an appointment](https://www.app2email.com/docs/api/calendar/add-booking-note.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/notes` | [The internal notes of a customer](https://www.app2email.com/docs/api/calendar/list-customer-notes.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/notes` | [Add an internal note to a customer](https://www.app2email.com/docs/api/calendar/add-customer-note.md) | `bookings:manage` | refused |
| DELETE | `/v1/{number}/bookings/notes/{note_id}` | [Delete an internal note](https://www.app2email.com/docs/api/calendar/delete-booking-note.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/links` | [The personal booking links](https://www.app2email.com/docs/api/calendar/list-booking-links.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/links` | [Make a link that opens the online booking page](https://www.app2email.com/docs/api/calendar/create-booking-link.md) | `bookings:manage` | refused |
| DELETE | `/v1/{number}/bookings/links/{code}` | [Revoke a personal booking link](https://www.app2email.com/docs/api/calendar/revoke-booking-link.md) | `bookings:manage` | refused |
| POST | `/v1/{number}/bookings/holds` | [Keep a free time for a few minutes](https://www.app2email.com/docs/api/calendar/create-booking-hold.md) | `bookings:manage` | refused |
| DELETE | `/v1/{number}/bookings/holds/{reference}` | [Release a held time](https://www.app2email.com/docs/api/calendar/release-booking-hold.md) | `bookings:manage` | refused |
