@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/appointments.md

@@ -0,0 +1,3917 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.appointments`: Appointments
+
+92 operations (31 read, 27 write, 16 destructive, 18 external).
+
+No hand-written client covers this area. Call it through `g8.api.appointments.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [appointments.d.ts](appointments.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addBookingGuests`](#op-addbookingguests) | `POST /api/v1/appointments/bookings/{booking_uid}/guests` | external | `meetings:run` | Add guest attendees to a booking |
+| [`addBookingNote`](#op-addbookingnote) | `POST /api/v1/appointments/bookings/{booking_uid}/notes` | external | `meetings:run` | Add an internal note to a booking |
+| [`addEventTypeHost`](#op-addeventtypehost) | `POST /api/v1/appointments/event-types/{event_type_id}/hosts` | write | `meetings:write` | Add Event Type Host |
+| [`assignAllMembers`](#op-assignallmembers) | `POST /api/v1/appointments/event-types/{event_type_id}/members/all` | write | `meetings:write` | Assign All Members |
+| [`assignManagedMember`](#op-assignmanagedmember) | `POST /api/v1/appointments/event-types/{event_type_id}/members` | write | `meetings:write` | Assign Managed Member |
+| [`cancelBooking`](#op-cancelbooking) | `POST /api/v1/appointments/bookings/{booking_uid}/cancel` | destructive | `meetings:delete` | Cancel a booking and notify both parties |
+| [`clearEventTypeDestinationCalendar`](#op-cleareventtypedestinationcalendar) | `DELETE /api/v1/appointments/event-types/{event_type_id}/destination-calendar` | destructive | `meetings:delete` | Clear Event Type Destination Calendar |
+| [`confirmBooking`](#op-confirmbooking) | `POST /api/v1/appointments/bookings/{booking_uid}/confirm` | external | `meetings:run` | Confirm or reject a pending booking |
+| [`connectConferencing`](#op-connectconferencing) | `POST /api/v1/appointments/conferencing/connect/{provider}` | external | `meetings:run` | Connect a conferencing provider (link-based / no-OAuth only) |
+| [`createBooking`](#op-createbooking) | `POST /api/v1/appointments/bookings` | external | `meetings:run` | Create a booking (charges credits + sends notifications) |
+| [`createEventType`](#op-createeventtype) | `POST /api/v1/appointments/event-types` | write | `meetings:write` | Create a bookable event type |
+| [`createEventTypeHostGroup`](#op-createeventtypehostgroup) | `POST /api/v1/appointments/event-types/{event_type_id}/host-groups` | write | `meetings:write` | Create Event Type Host Group |
+| [`createOoo`](#op-createooo) | `POST /api/v1/appointments/out-of-office` | write | `meetings:write` | Create an out-of-office entry |
+| [`createRoutingForm`](#op-createroutingform) | `POST /api/v1/appointments/routing-forms` | write | `meetings:write` | Create a routing form |
+| [`createSavedFilter`](#op-createsavedfilter) | `POST /api/v1/appointments/saved-filters` | write | `meetings:write` | Create Saved Filter |
+| [`createSchedule`](#op-createschedule) | `POST /api/v1/appointments/schedules` | write | `meetings:write` | Create an availability schedule |
+| [`createWorkflow`](#op-createworkflow) | `POST /api/v1/appointments/workflows` | external | `meetings:run` | Create a workflow |
+| [`deleteEventType`](#op-deleteeventtype) | `DELETE /api/v1/appointments/event-types/{event_type_id}` | destructive | `meetings:delete` | Delete an event type |
+| [`deleteEventTypeHostGroup`](#op-deleteeventtypehostgroup) | `DELETE /api/v1/appointments/event-types/{event_type_id}/host-groups/{group_id}` | destructive | `meetings:delete` | Delete Event Type Host Group |
+| [`deleteOoo`](#op-deleteooo) | `DELETE /api/v1/appointments/out-of-office/{ooo_uuid}` | destructive | `meetings:delete` | Delete an out-of-office entry |
+| [`deleteRoutingForm`](#op-deleteroutingform) | `DELETE /api/v1/appointments/routing-forms/{form_id}` | destructive | `meetings:delete` | Delete a routing form (cascades fields and routes) |
+| [`deleteSavedFilter`](#op-deletesavedfilter) | `DELETE /api/v1/appointments/saved-filters/{filter_id}` | destructive | `meetings:delete` | Delete Saved Filter |
+| [`deleteSchedule`](#op-deleteschedule) | `DELETE /api/v1/appointments/schedules/{schedule_id}` | destructive | `meetings:delete` | Delete a schedule |
+| [`deleteWorkflow`](#op-deleteworkflow) | `DELETE /api/v1/appointments/workflows/{workflow_id}` | destructive | `meetings:delete` | Delete a workflow and cancel pending reminders |
+| [`deselectCalendar`](#op-deselectcalendar) | `DELETE /api/v1/appointments/calendars/selected` | destructive | `meetings:delete` | Deselect a sub-calendar from conflict checking |
+| [`disconnectCalendar`](#op-disconnectcalendar) | `DELETE /api/v1/appointments/calendars/{credential_id}` | destructive | `meetings:delete` | Disconnect a calendar account |
+| [`disconnectConferencing`](#op-disconnectconferencing) | `DELETE /api/v1/appointments/conferencing/{provider}/disconnect` | destructive | `meetings:delete` | Disconnect a conferencing provider |
+| [`duplicateEventType`](#op-duplicateeventtype) | `POST /api/v1/appointments/event-types/{event_type_id}/duplicate` | write | `meetings:write` | Duplicate an event type (with a '-copy' slug) |
+| [`duplicateRoutingForm`](#op-duplicateroutingform) | `POST /api/v1/appointments/routing-forms/{form_id}/duplicate` | write | `meetings:write` | Duplicate a routing form (copy with all fields and routes) |
+| [`exportBookingInsights`](#op-exportbookinginsights) | `GET /api/v1/appointments/bookings/insights/export` | read | `meetings:read` | Export Booking Insights |
+| [`exportRoutingFormResponses`](#op-exportroutingformresponses) | `GET /api/v1/appointments/routing-forms/{form_id}/responses/export` | read | `meetings:read` | Export Routing Form Responses |
+| [`getAvailability`](#op-getavailability) | `GET /api/v1/appointments/schedules/{schedule_id}/availability` | read | `meetings:read` | Get availability rules and overrides for a schedule |
+| [`getAvailableSlots`](#op-getavailableslots) | `GET /api/v1/appointments/slots` | read | `meetings:read` | Get Available Slots |
+| [`getBooking`](#op-getbooking) | `GET /api/v1/appointments/bookings/{booking_uid}` | read | `meetings:read` | Get a single booking by UID |
+| [`getBookingInsights`](#op-getbookinginsights) | `GET /api/v1/appointments/bookings/insights` | read | `meetings:read` | Get aggregated booking insights |
+| [`getDefaultConferencing`](#op-getdefaultconferencing) | `GET /api/v1/appointments/conferencing/default` | read | `meetings:read` | Get the current default conferencing provider |
+| [`getDestinationCalendar`](#op-getdestinationcalendar) | `GET /api/v1/appointments/calendars/destination` | read | `meetings:read` | Get the destination calendar (with event-type fallback) |
+| [`getEmbedConfig`](#op-getembedconfig) | `GET /api/v1/appointments/event-types/{event_type_id}/embed` | read | `meetings:read` | Get Embed Config |
+| [`getEventType`](#op-geteventtype) | `GET /api/v1/appointments/event-types/{event_type_id}` | read | `meetings:read` | Get full detail for one bookable event type |
+| [`getEventTypeDestinationCalendar`](#op-geteventtypedestinationcalendar) | `GET /api/v1/appointments/event-types/{event_type_id}/destination-calendar` | read | `meetings:read` | Get Event Type Destination Calendar |
+| [`getEventTypeSelectedCalendars`](#op-geteventtypeselectedcalendars) | `GET /api/v1/appointments/event-types/{event_type_id}/selected-calendars` | read | `meetings:read` | Get Event Type Selected Calendars |
+| [`getOrgSettings`](#op-getorgsettings) | `GET /api/v1/appointments/org-settings` | read | `meetings:read` | Get Org Settings |
+| [`getRoutingForm`](#op-getroutingform) | `GET /api/v1/appointments/routing-forms/{form_id}` | read | `meetings:read` | Get a single routing form |
+| [`getSchedule`](#op-getschedule) | `GET /api/v1/appointments/schedules/{schedule_id}` | read | `meetings:read` | Get a schedule with availability and linked event types |
+| [`getScheduleProfile`](#op-getscheduleprofile) | `GET /api/v1/appointments/profile` | read | `meetings:read` | Get Schedule Profile |
+| [`getWorkflow`](#op-getworkflow) | `GET /api/v1/appointments/workflows/{workflow_id}` | read | `meetings:read` | Get a single workflow |
+| [`importMeeting`](#op-importmeeting) | `POST /api/v1/appointments/bookings/import` | external | `meetings:run` | Import Meeting |
+| [`listBookings`](#op-listbookings) | `GET /api/v1/appointments/bookings` | read | `meetings:read` | List the caller's bookings (paginated) |
+| [`listCalendarEvents`](#op-listcalendarevents) | `GET /api/v1/appointments/calendars/events` | read | `meetings:read` | List Calendar Events |
+| [`listCalendars`](#op-listcalendars) | `GET /api/v1/appointments/calendars` | read | `meetings:read` | List connected calendar accounts |
+| [`listConferencing`](#op-listconferencing) | `GET /api/v1/appointments/conferencing` | read | `meetings:read` | List connected conferencing providers |
+| [`listEventTypeHostGroups`](#op-listeventtypehostgroups) | `GET /api/v1/appointments/event-types/{event_type_id}/host-groups` | read | `meetings:read` | List Event Type Host Groups |
+| [`listMembership`](#op-listmembership) | `GET /api/v1/appointments/membership` | read | `meetings:read` | List Membership |
+| [`listOoo`](#op-listooo) | `GET /api/v1/appointments/out-of-office` | read | `meetings:read` | List out-of-office entries for the calling user |
+| [`listRoutingFormResponses`](#op-listroutingformresponses) | `GET /api/v1/appointments/routing-forms/{form_id}/responses` | read | `meetings:read` | List captured responses for a routing form (paginated) |
+| [`listRoutingForms`](#op-listroutingforms) | `GET /api/v1/appointments/routing-forms` | read | `meetings:read` | List routing forms (includes response_count) |
+| [`listSavedFilters`](#op-listsavedfilters) | `GET /api/v1/appointments/saved-filters` | read | `meetings:read` | List Saved Filters |
+| [`listSchedules`](#op-listschedules) | `GET /api/v1/appointments/schedules` | read | `meetings:read` | List the caller's availability schedules |
+| [`listSequencesForPicker`](#op-listsequencesforpicker) | `GET /api/v1/appointments/bookings/sequences-picker` | read | `meetings:read` | List Sequences For Picker |
+| [`listTeamAvailability`](#op-listteamavailability) | `GET /api/v1/appointments/availability/team` | read | `meetings:read` | List Team Availability |
+| [`listWorkflows`](#op-listworkflows) | `GET /api/v1/appointments/workflows` | read | `meetings:read` | List all workflows |
+| [`markAbsent`](#op-markabsent) | `POST /api/v1/appointments/bookings/{booking_uid}/mark-absent` | external | `meetings:run` | Mark host or attendees as no-show |
+| [`releaseSlot`](#op-releaseslot) | `DELETE /api/v1/appointments/slots/reserve/{slot_uid}` | destructive | `meetings:delete` | Release Slot |
+| [`removeEventTypeHost`](#op-removeeventtypehost) | `DELETE /api/v1/appointments/event-types/{event_type_id}/hosts/{host_user_id}` | destructive | `meetings:delete` | Remove Event Type Host |
+| [`requestBookingReschedule`](#op-requestbookingreschedule) | `POST /api/v1/appointments/bookings/{booking_uid}/request-reschedule` | external | `meetings:run` | Send a reschedule-request email to the attendee (host action) |
+| [`rescheduleBooking`](#op-reschedulebooking) | `POST /api/v1/appointments/bookings/{booking_uid}/reschedule` | external | `meetings:run` | Reschedule a booking to a new start time |
+| [`reserveSlot`](#op-reserveslot) | `POST /api/v1/appointments/slots/reserve` | write | `meetings:write` | Reserve Slot |
+| [`selectCalendar`](#op-selectcalendar) | `POST /api/v1/appointments/calendars/selected` | external | `meetings:run` | Select a sub-calendar for conflict checking |
+| [`setDefaultConferencing`](#op-setdefaultconferencing) | `POST /api/v1/appointments/conferencing/{provider}/default` | external | `meetings:run` | Set the default conferencing provider |
+| [`setDefaultSchedule`](#op-setdefaultschedule) | `POST /api/v1/appointments/schedules/{schedule_id}/set-default` | write | `meetings:write` | Set a schedule as the caller's default |
+| [`setDestinationCalendar`](#op-setdestinationcalendar) | `PUT /api/v1/appointments/calendars/destination` | external | `meetings:run` | Set the destination calendar for new booking events |
+| [`setEventTypeDestinationCalendar`](#op-seteventtypedestinationcalendar) | `PUT /api/v1/appointments/event-types/{event_type_id}/destination-calendar` | write | `meetings:write` | Set Event Type Destination Calendar |
+| [`setEventTypeSelectedCalendars`](#op-seteventtypeselectedcalendars) | `PUT /api/v1/appointments/event-types/{event_type_id}/selected-calendars` | write | `meetings:write` | Set Event Type Selected Calendars |
+| [`setLockedFields`](#op-setlockedfields) | `PUT /api/v1/appointments/event-types/{event_type_id}/locked-fields` | write | `meetings:write` | Set Locked Fields |
+| [`setProviderLink`](#op-setproviderlink) | `PUT /api/v1/appointments/conferencing/{provider}/link` | external | `meetings:run` | Set or update a link-based conferencing provider's meeting URL |
+| [`toggleWorkflow`](#op-toggleworkflow) | `POST /api/v1/appointments/workflows/{workflow_id}/toggle` | external | `meetings:run` | Activate or deactivate a workflow |
+| [`unassignManagedMember`](#op-unassignmanagedmember) | `DELETE /api/v1/appointments/event-types/{event_type_id}/members/{user_id}` | destructive | `meetings:delete` | Unassign Managed Member |
+| [`updateAvailability`](#op-updateavailability) | `PATCH /api/v1/appointments/schedules/{schedule_id}/availability` | write | `meetings:write` | Replace availability rules and/or date overrides for a schedule |
+| [`updateBookingLocation`](#op-updatebookinglocation) | `PATCH /api/v1/appointments/bookings/{booking_uid}/location` | external | `meetings:run` | Update the meeting location and notify both parties |
+| [`updateBookingSequence`](#op-updatebookingsequence) | `PATCH /api/v1/appointments/bookings/{booking_uid}/sequence` | external | `meetings:run` | Associate a booking with a sequence (or detach) |
+| [`updateEmbedConfig`](#op-updateembedconfig) | `PATCH /api/v1/appointments/event-types/{event_type_id}/embed` | write | `meetings:write` | Update Embed Config |
+| [`updateEventType`](#op-updateeventtype) | `PATCH /api/v1/appointments/event-types/{event_type_id}` | write | `meetings:write` | Update an event type (partial) |
+| [`updateEventTypeHost`](#op-updateeventtypehost) | `PATCH /api/v1/appointments/event-types/{event_type_id}/hosts/{host_user_id}` | write | `meetings:write` | Update Event Type Host |
+| [`updateEventTypeHostGroup`](#op-updateeventtypehostgroup) | `PATCH /api/v1/appointments/event-types/{event_type_id}/host-groups/{group_id}` | write | `meetings:write` | Update Event Type Host Group |
+| [`updateMemberRole`](#op-updatememberrole) | `PATCH /api/v1/appointments/membership/by-user/{user_id}/role` | destructive | `meetings:delete` | Update Member Role |
+| [`updateOoo`](#op-updateooo) | `PATCH /api/v1/appointments/out-of-office/{ooo_uuid}` | write | `meetings:write` | Update an out-of-office entry |
+| [`updateOrgSettings`](#op-updateorgsettings) | `PATCH /api/v1/appointments/org-settings` | write | `meetings:write` | Update Org Settings |
+| [`updateRoutingForm`](#op-updateroutingform) | `PATCH /api/v1/appointments/routing-forms/{form_id}` | write | `meetings:write` | Update a routing form (partial) |
+| [`updateSavedFilter`](#op-updatesavedfilter) | `PUT /api/v1/appointments/saved-filters/{filter_id}` | write | `meetings:write` | Update Saved Filter |
+| [`updateSchedule`](#op-updateschedule) | `PATCH /api/v1/appointments/schedules/{schedule_id}` | write | `meetings:write` | Update a schedule (partial) |
+| [`updateScheduleProfile`](#op-updatescheduleprofile) | `PATCH /api/v1/appointments/profile` | write | `meetings:write` | Update Schedule Profile |
+| [`updateWorkflow`](#op-updateworkflow) | `PATCH /api/v1/appointments/workflows/{workflow_id}` | external | `meetings:run` | Update a workflow (partial) |
+
+---
+
+<a id="op-addbookingguests"></a>
+
+### `g8.api.appointments.addBookingGuests(input)`
+
+**Add guest attendees to a booking**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/guests`
+- operationId: `add_booking_guests_appointments_bookings__booking_uid__guests_post` (also callable as `g8.api.call("add_booking_guests_appointments_bookings__booking_uid__guests_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Invite additional guests (email addresses) to an existing booking.
+
+Sends notification emails to each new guest and updates the booking's
+attendee list.  Backed by ``BookingsHandler.handle_add_guests``.
+Raises 404 when the booking uid is not visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `AddGuestsRequest` | yes | Request body; fields below. |
+
+Body fields (`AddGuestsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.guests` | `Array<string>` | yes |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.addBookingGuests({ path: { booking_uid: "example" }, body: { guests: ["example"] } });
+```
+
+---
+
+<a id="op-addbookingnote"></a>
+
+### `g8.api.appointments.addBookingNote(input)`
+
+**Add an internal note to a booking**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/notes`
+- operationId: `add_booking_note_appointments_bookings__booking_uid__notes_post` (also callable as `g8.api.call("add_booking_note_appointments_bookings__booking_uid__notes_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Append an internal (host-only) note to a booking.
+
+Notes are not visible to attendees; they appear in the booking detail
+view for org members.  Backed by ``BookingsHandler.handle_add_note``.
+Raises 404 when the booking uid is not visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `AddNoteRequest` | yes | Request body; fields below. |
+
+Body fields (`AddNoteRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.text` | `string` | yes |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.addBookingNote({ path: { booking_uid: "example" }, body: { text: "example" } });
+```
+
+---
+
+<a id="op-addeventtypehost"></a>
+
+### `g8.api.appointments.addEventTypeHost(input)`
+
+**Add Event Type Host**
+
+- HTTP: `POST /api/v1/appointments/event-types/{event_type_id}/hosts`
+- operationId: `add_event_type_host_appointments_event_types__event_type_id__hosts_post` (also callable as `g8.api.call("add_event_type_host_appointments_event_types__event_type_id__hosts_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Add a host to an event type.
+
+`is_fixed` is the round-robin distinction that matters: a FIXED host is on
+every booking, a non-fixed host is one of the rotation. Getting it wrong
+silently changes who gets booked, so it is declared rather than defaulted
+into ambiguity.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `AppointmentHostCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`AppointmentHostCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.user_id` | `integer` | yes | User to add as a host. |
+| `body.group_id` | `string \| null` | no |  |
+| `body.is_fixed` | `boolean` | no | True = on every booking; false = one of the round-robin rotation. default `false` |
+| `body.priority` | `integer \| null` | no |  |
+| `body.schedule_id` | `integer \| null` | no |  |
+| `body.weight` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_AppointmentHost_`: the envelope `{ data: AppointmentHost, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`AppointmentHost` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `avatar_url` | `string \| null` | no |  |
+| `email` | `string \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `group_id` | `string \| null` | no | Host group, if partitioned. |
+| `is_fixed` | `boolean \| null` | no | True = on EVERY booking. False = one of the round-robin rotation. This is the setting that decides who actually gets booked. |
+| `name` | `string \| null` | no |  |
+| `priority` | `integer \| null` | no | Rotation priority. |
+| `schedule_id` | `integer \| null` | no | Availability schedule this host is booked against. |
+| `user_id` | `integer \| null` | no |  |
+| `weight` | `integer \| null` | no | Relative share of the rotation. |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.addEventTypeHost({ path: { event_type_id: 123 }, body: { user_id: 123 } });
+```
+
+---
+
+<a id="op-assignallmembers"></a>
+
+### `g8.api.appointments.assignAllMembers(input)`
+
+**Assign All Members**
+
+- HTTP: `POST /api/v1/appointments/event-types/{event_type_id}/members/all`
+- operationId: `assign_all_members_appointments_event_types__event_type_id__members_all_post` (also callable as `g8.api.call("assign_all_members_appointments_event_types__event_type_id__members_all_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Give EVERY active member their own bookable copy of a managed template.
+
+Idempotent - members who already have a copy are skipped.
+`include_future_joiners` is a standing rule: leave it true and someone who
+joins next month gets a copy without anyone running this again.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `BulkAssignMembersRequest` | no | Request body; fields below. |
+
+Body fields (`BulkAssignMembersRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.include_future_joiners` | `boolean` | no | When true, members who join the organisation LATER also get a copy automatically. A standing rule, not a one-off action. default `false` |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.assignAllMembers({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-assignmanagedmember"></a>
+
+### `g8.api.appointments.assignManagedMember(input)`
+
+**Assign Managed Member**
+
+- HTTP: `POST /api/v1/appointments/event-types/{event_type_id}/members`
+- operationId: `assign_managed_member_appointments_event_types__event_type_id__members_post` (also callable as `g8.api.call("assign_managed_member_appointments_event_types__event_type_id__members_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Give ONE member their own bookable copy of a managed template.
+
+The template itself is not bookable - it distributes a child event type
+per member, which is what that member's booking link points at.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `AssignManagedMemberRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignManagedMemberRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.user_id` | `integer` | yes | The member's INTEGER scheduling user id - the `user_id` field of `GET /appointments/membership`. Not an email, not a PropelAuth id. min 1 |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.assignManagedMember({ path: { event_type_id: 123 }, body: { user_id: 1 } });
+```
+
+---
+
+<a id="op-cancelbooking"></a>
+
+### `g8.api.appointments.cancelBooking(input)`
+
+**Cancel a booking and notify both parties**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/cancel`
+- operationId: `cancel_booking_appointments_bookings__booking_uid__cancel_post` (also callable as `g8.api.call("cancel_booking_appointments_bookings__booking_uid__cancel_post", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Cancel a booking. Reuses ``BookingsHandler.handle_cancel`` (sends the
+cancellation emails, releases the slot, emits the EDA event). Body is
+optional — omit it to cancel with no reason.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes |  |
+| `body` | `CancelBookingRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.cancel_subsequent` | `boolean` | no | default `false` |
+| `body.cancellation_reason` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.cancelBooking({ path: { booking_uid: "example" } });
+```
+
+---
+
+<a id="op-cleareventtypedestinationcalendar"></a>
+
+### `g8.api.appointments.clearEventTypeDestinationCalendar(input)`
+
+**Clear Event Type Destination Calendar**
+
+- HTTP: `DELETE /api/v1/appointments/event-types/{event_type_id}/destination-calendar`
+- operationId: `clear_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_delete` (also callable as `g8.api.call("clear_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Drop the per-event-type override. The ACCOUNT default is untouched, so
+bookings fall back to it rather than stopping.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.clearEventTypeDestinationCalendar({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-confirmbooking"></a>
+
+### `g8.api.appointments.confirmBooking(input)`
+
+**Confirm or reject a pending booking**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/confirm`
+- operationId: `confirm_booking_appointments_bookings__booking_uid__confirm_post` (also callable as `g8.api.call("confirm_booking_appointments_bookings__booking_uid__confirm_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Confirm or reject a booking that requires host approval.
+
+When ``confirmed=True`` the booking moves from ``pending`` to
+``accepted`` and confirmation emails are sent.  When ``confirmed=False``
+the booking is rejected and the attendee is notified with the optional
+``reason``.  Backed by ``BookingsHandler.handle_confirm``; raises 404
+when the booking uid is not visible to the caller, 403 on permission.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `ConfirmBookingRequest` | yes | Request body; fields below. |
+
+Body fields (`ConfirmBookingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.confirmed` | `boolean` | yes |  |
+| `body.reason` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.confirmBooking({ path: { booking_uid: "example" }, body: { confirmed: true } });
+```
+
+---
+
+<a id="op-connectconferencing"></a>
+
+### `g8.api.appointments.connectConferencing(input)`
+
+**Connect a conferencing provider (link-based / no-OAuth only)**
+
+- HTTP: `POST /api/v1/appointments/conferencing/connect/{provider}`
+- operationId: `connect_conferencing_appointments_conferencing_connect__provider__post` (also callable as `g8.api.call("connect_conferencing_appointments_conferencing_connect__provider__post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Connect a conferencing provider that does not require a browser OAuth
+flow. Supported providers: google_meet, roam, roam_auto, whereby, jitsi.
+Zoom and office365_video (Teams) are excluded - they require a browser
+OAuth redirect that cannot be completed via an API key.
+
+google_meet: clears the google_meet_suppressed flag (requires an existing
+google_calendar credential - no credential row is created for Meet itself).
+
+roam, whereby, jitsi: creates a credential row; optional ``link`` is the
+meeting URL validated against the provider's URL pattern.
+
+roam_auto: creates a stub credential row (no OAuth tokens - the Roam Auto
+integration requires a prior OAuth flow to be completed in the web app).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `string` | yes | Provider: google_meet \| roam \| roam_auto \| whereby \| jitsi |
+| `body` | `Body_connect_conferencing_appointments_conferencing_connect__provider__post` | no | Request body; fields below. |
+
+Body fields (`Body_connect_conferencing_appointments_conferencing_connect__provider__post`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.link` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.connectConferencing({ path: { provider: "example" } });
+```
+
+---
+
+<a id="op-createbooking"></a>
+
+### `g8.api.appointments.createBooking(input)`
+
+**Create a booking (charges credits + sends notifications)**
+
+- HTTP: `POST /api/v1/appointments/bookings`
+- operationId: `create_booking_appointments_bookings_post` (also callable as `g8.api.call("create_booking_appointments_bookings_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Create (book) an appointment on behalf of the API key's user.
+
+Reuses ``BookingsHandler.handle_create`` verbatim — same host selection,
+conflict checks, credit charge (~20 credits), calendar push, attendee
+notifications, and EDA emit as an in-app booking. Surfaces the handler's
+402 (insufficient credits) / 409 (slot conflict) / 404 (event type)
+untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateBookingRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateBookingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.attendees` | `Array<AttendeeInput>` | yes |  |
+| `body.event_type_id` | `integer` | yes |  |
+| `body.start_time` | `string` | yes |  |
+| `body.end_time` | `string \| null` | no |  |
+| `body.guests` | `Array<string> \| null` | no |  |
+| `body.language` | `string` | no | default `"en"` |
+| `body.location` | `string \| null` | no |  |
+| `body.metadata` | `Record<string, unknown> \| null` | no |  |
+| `body.override_availability` | `boolean` | no | default `false` |
+| `body.recurring_event_id` | `string \| null` | no |  |
+| `body.responses` | `Record<string, unknown> \| null` | no |  |
+| `body.selected_conferencing` | `LocationItem \| null` | no |  |
+| `body.selected_location` | `LocationItem \| null` | no |  |
+| `body.slot_uid` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.createBooking({
+  body: {
+    attendees: [{ email: "jane@acme.com", name: "Example" }],
+    event_type_id: 123,
+    start_time: "example",
+  },
+});
+```
+
+---
+
+<a id="op-createeventtype"></a>
+
+### `g8.api.appointments.createEventType(input)`
+
+**Create a bookable event type**
+
+- HTTP: `POST /api/v1/appointments/event-types`
+- operationId: `create_event_type_appointments_event_types_post` (also callable as `g8.api.call("create_event_type_appointments_event_types_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Create a new event type. Reuses ``EventTypesHandler.handle_create``
+verbatim (slug uniqueness, host wiring, schedule attach), so the result is
+identical to creating one in the app. ``slug`` must be unique within the org
+(409 on collision); ``length`` is the meeting duration in minutes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateEventTypeRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateEventTypeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.length` | `integer` | yes |  |
+| `body.slug` | `string` | yes |  |
+| `body.title` | `string` | yes |  |
+| `body.after_event_buffer` | `integer` | no | default `0` |
+| `body.before_event_buffer` | `integer` | no | default `0` |
+| `body.booking_fields` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.default_layout` | `string \| null` | no |  |
+| `body.description` | `string \| null` | no |  |
+| `body.disable_cancelling` | `boolean` | no | default `false` |
+| `body.disable_guests` | `boolean` | no | default `false` |
+| `body.disable_rescheduling` | `boolean` | no | default `false` |
+| `body.event_color` | `string \| null` | no |  |
+| `body.event_name` | `string \| null` | no |  |
+| `body.hidden` | `boolean` | no | default `false` |
+| `body.initial_hosts` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.layouts` | `Array<string> \| null` | no |  |
+| `body.locations` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.metadata` | `Record<string, unknown> \| null` | no |  |
+| `body.minimum_booking_notice` | `integer` | no | default `120` |
+| `body.period_days` | `integer \| null` | no |  |
+| `body.period_end_date` | `string \| null` | no |  |
+| `body.period_start_date` | `string \| null` | no |  |
+| `body.period_type` | `string` | no | default `"unlimited"` |
+| `body.recurring_event` | `Record<string, unknown> \| null` | no |  |
+| `body.requires_confirmation` | `boolean` | no | default `false` |
+| `body.schedule_id` | `integer \| null` | no |  |
+| `body.scheduling_type` | `string \| null` | no |  |
+| `body.seats_per_time_slot` | `integer \| null` | no |  |
+| `body.slot_interval` | `integer \| null` | no |  |
+| `body.success_redirect_url` | `string \| null` | no |  |
+| `body.time_zone` | `string \| null` | no |  |
+| `body.use_common_schedule` | `boolean \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createEventType({ body: { length: 1, slug: "example", title: "Example" } });
+```
+
+---
+
+<a id="op-createeventtypehostgroup"></a>
+
+### `g8.api.appointments.createEventTypeHostGroup(input)`
+
+**Create Event Type Host Group**
+
+- HTTP: `POST /api/v1/appointments/event-types/{event_type_id}/host-groups`
+- operationId: `create_event_type_host_group_appointments_event_types__event_type_id__host_groups_post` (also callable as `g8.api.call("create_event_type_host_group_appointments_event_types__event_type_id__host_groups_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Create a host group. Assign hosts to it via `group_id` on a host.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `AppointmentHostGroupWriteRequest` | yes | Request body; fields below. |
+
+Body fields (`AppointmentHostGroupWriteRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | Group name. min length 1 |
+
+**Returns** `ApiResponse_AppointmentHostGroup_`: the envelope `{ data: AppointmentHostGroup, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`AppointmentHostGroup` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `created_at` | `string (date-time) \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createEventTypeHostGroup({ path: { event_type_id: 123 }, body: { name: "Example" } });
+```
+
+---
+
+<a id="op-createooo"></a>
+
+### `g8.api.appointments.createOoo(input)`
+
+**Create an out-of-office entry**
+
+- HTTP: `POST /api/v1/appointments/out-of-office`
+- operationId: `create_ooo_appointments_out_of_office_post` (also callable as `g8.api.call("create_ooo_appointments_out_of_office_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Create an out-of-office entry for the calling user. While active, the
+user's slots are blocked for booking. ``start`` and ``end`` may be local
+calendar dates paired with ``time_zone`` or legacy ISO-8601 datetimes.
+Optional ``to_user_id`` exposes an alternative teammate booking path.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateOutOfOfficeRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateOutOfOfficeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.end` | `string` | yes |  |
+| `body.start` | `string` | yes |  |
+| `body.notes` | `string \| null` | no |  |
+| `body.public_note` | `string \| null` | no |  |
+| `body.reason` | `string \| null` | no |  |
+| `body.time_zone` | `string \| null` | no |  |
+| `body.to_user_id` | `integer \| null` | no |  |
+| `body.user_id` | `integer \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createOoo({ body: { end: "example", start: "example" } });
+```
+
+---
+
+<a id="op-createroutingform"></a>
+
+### `g8.api.appointments.createRoutingForm(input)`
+
+**Create a routing form**
+
+- HTTP: `POST /api/v1/appointments/routing-forms`
+- operationId: `create_routing_form_appointments_routing_forms_post` (also callable as `g8.api.call("create_routing_form_appointments_routing_forms_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Create a new routing form with optional fields and routes.
+
+Returns the created form including its generated slug. ``is_admin`` is
+forced False so the form is owned by the API-key user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateRoutingFormRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateRoutingFormRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1, max length 255 |
+| `body.description` | `string \| null` | no |  |
+| `body.disabled` | `boolean` | no | default `false` |
+| `body.fields` | `Array<RoutingFormField>` | no |  |
+| `body.routes` | `Array<RoutingFormRouteInput>` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createRoutingForm({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-createsavedfilter"></a>
+
+### `g8.api.appointments.createSavedFilter(input)`
+
+**Create Saved Filter**
+
+- HTTP: `POST /api/v1/appointments/saved-filters`
+- operationId: `create_saved_filter_appointments_saved_filters_post` (also callable as `g8.api.call("create_saved_filter_appointments_saved_filters_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Save a view. A second view with the same title is a 409.
+
+`state` is the filter itself and is round-tripped as-is.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateSavedFilterRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateSavedFilterRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.title` | `string` | yes | min length 1, max length 120 |
+| `body.description` | `string \| null` | no | max length 2000 |
+| `body.state` | `Record<string, unknown>` | no | The filter itself. Opaque to this contract and round-tripped as-is. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createSavedFilter({ body: { title: "Example" } });
+```
+
+---
+
+<a id="op-createschedule"></a>
+
+### `g8.api.appointments.createSchedule(input)`
+
+**Create an availability schedule**
+
+- HTTP: `POST /api/v1/appointments/schedules`
+- operationId: `create_schedule_appointments_schedules_post` (also callable as `g8.api.call("create_schedule_appointments_schedules_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Create a named availability schedule with weekly rules and optional date overrides.
+
+Defaults to Mon-Fri 09:00-17:00 when ``availability`` is omitted.
+Pass ``is_default=True`` to immediately set this as the caller's default
+schedule (persisted via ``update_appointment_settings``).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateScheduleRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateScheduleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes |  |
+| `body.time_zone` | `string` | yes |  |
+| `body.availability` | `Array<AvailabilityInput> \| null` | no |  |
+| `body.is_default` | `boolean` | no | default `false` |
+| `body.overrides` | `Array<OverrideInput> \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.createSchedule({ body: { name: "Example", time_zone: "example" } });
+```
+
+---
+
+<a id="op-createworkflow"></a>
+
+### `g8.api.appointments.createWorkflow(input)`
+
+**Create a workflow**
+
+- HTTP: `POST /api/v1/appointments/workflows`
+- operationId: `create_workflow_appointments_workflows_post` (also callable as `g8.api.call("create_workflow_appointments_workflows_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Create a new workflow. Steps define the actions to take; event_type_ids
+attaches the workflow to specific event types (omit or set ``is_active_on_all``
+to apply org-wide). ``trigger`` must be one of: new_booking, before_event,
+after_event, booking_cancelled, booking_rescheduled. Time-based triggers
+(before_event / after_event) require ``time`` and ``time_unit``.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateWorkflowRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateWorkflowRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1, max length 255 |
+| `body.steps` | `Array<WorkflowStepInput>` | yes | min items 1, max items 20 |
+| `body.trigger` | `"new_booking" \| "before_event" \| "after_event" \| "booking_cancelled" \| "booking_rescheduled"` | yes |  |
+| `body.event_type_ids` | `Array<integer> \| null` | no |  |
+| `body.is_active_on_all` | `boolean` | no | default `false` |
+| `body.time` | `integer \| null` | no | min 1 |
+| `body.time_unit` | `"minutes" \| "hours" \| "days" \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.createWorkflow({
+  body: {
+    name: "Example",
+    steps: [{ action: "email_host" }],
+    trigger: "new_booking",
+  },
+});
+```
+
+---
+
+<a id="op-deleteeventtype"></a>
+
+### `g8.api.appointments.deleteEventType(input)`
+
+**Delete an event type**
+
+- HTTP: `DELETE /api/v1/appointments/event-types/{event_type_id}`
+- operationId: `delete_event_type_appointments_event_types__event_type_id__delete` (also callable as `g8.api.call("delete_event_type_appointments_event_types__event_type_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete an event type. Reuses ``EventTypesHandler.handle_delete``.
+
+``EventTypePolicy.can_delete()`` is ADMIN-ONLY (Cal.com "team event delete =
+admin only"; hosts cannot delete). So this requires the API key's user to
+hold Admin/Owner in the org - resolved via ``_is_org_admin``. Member/Viewer
+keys and org-scoped machine keys get a 403 from the handler. Returns
+``{data: {deleted: true, event_type_id}}`` on success.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event-type integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteEventType({ path: { event_type_id: 1 } });
+```
+
+---
+
+<a id="op-deleteeventtypehostgroup"></a>
+
+### `g8.api.appointments.deleteEventTypeHostGroup(input)`
+
+**Delete Event Type Host Group**
+
+- HTTP: `DELETE /api/v1/appointments/event-types/{event_type_id}/host-groups/{group_id}`
+- operationId: `delete_event_type_host_group_appointments_event_types__event_type_id__host_groups__group_id__delete` (also callable as `g8.api.call("delete_event_type_host_group_appointments_event_types__event_type_id__host_groups__group_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a host group. The hosts in it are NOT removed from the event
+type - they become ungrouped.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `path.group_id` | `string` | yes | Host group id. |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteEventTypeHostGroup({ path: { event_type_id: 123, group_id: "id" } });
+```
+
+---
+
+<a id="op-deleteooo"></a>
+
+### `g8.api.appointments.deleteOoo(input)`
+
+**Delete an out-of-office entry**
+
+- HTTP: `DELETE /api/v1/appointments/out-of-office/{ooo_uuid}`
+- operationId: `delete_ooo_appointments_out_of_office__ooo_uuid__delete` (also callable as `g8.api.call("delete_ooo_appointments_out_of_office__ooo_uuid__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete an out-of-office entry. Only the owner may delete their own
+entry (API keys force ``is_admin=False``). Returns
+``{data: {deleted: true, ooo_uuid}}`` on success.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.ooo_uuid` | `string` | yes | UUID of the out-of-office entry to delete. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteOoo({ path: { ooo_uuid: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-deleteroutingform"></a>
+
+### `g8.api.appointments.deleteRoutingForm(input)`
+
+**Delete a routing form (cascades fields and routes)**
+
+- HTTP: `DELETE /api/v1/appointments/routing-forms/{form_id}`
+- operationId: `delete_routing_form_appointments_routing_forms__form_id__delete` (also callable as `g8.api.call("delete_routing_form_appointments_routing_forms__form_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a routing form permanently. Cascades to its fields and routes.
+
+Returns 404 when the form does not exist or belongs to another user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Routing form integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteRoutingForm({ path: { form_id: 1 } });
+```
+
+---
+
+<a id="op-deletesavedfilter"></a>
+
+### `g8.api.appointments.deleteSavedFilter(input)`
+
+**Delete Saved Filter**
+
+- HTTP: `DELETE /api/v1/appointments/saved-filters/{filter_id}`
+- operationId: `delete_saved_filter_appointments_saved_filters__filter_id__delete` (also callable as `g8.api.call("delete_saved_filter_appointments_saved_filters__filter_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a saved view. The bookings it selected are untouched.
+
+Always a success, whether or not the id existed - the app does not
+disclose which filters exist, and this does not either.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.filter_id` | `string` | yes | Filter id (UUID). |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteSavedFilter({ path: { filter_id: "id" } });
+```
+
+---
+
+<a id="op-deleteschedule"></a>
+
+### `g8.api.appointments.deleteSchedule(input)`
+
+**Delete a schedule**
+
+- HTTP: `DELETE /api/v1/appointments/schedules/{schedule_id}`
+- operationId: `delete_schedule_appointments_schedules__schedule_id__delete` (also callable as `g8.api.call("delete_schedule_appointments_schedules__schedule_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a schedule. Returns 409 when this is the caller's last schedule
+(mirroring the in-app guard - every user must retain at least one schedule).
+Returns 404 when the schedule does not exist or belongs to another user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteSchedule({ path: { schedule_id: 1 } });
+```
+
+---
+
+<a id="op-deleteworkflow"></a>
+
+### `g8.api.appointments.deleteWorkflow(input)`
+
+**Delete a workflow and cancel pending reminders**
+
+- HTTP: `DELETE /api/v1/appointments/workflows/{workflow_id}`
+- operationId: `delete_workflow_appointments_workflows__workflow_id__delete` (also callable as `g8.api.call("delete_workflow_appointments_workflows__workflow_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a workflow and cancel any pending reminder rows created by it.
+Mirrors the in-app router: ``cancel_workflow_reminders`` is called BEFORE
+``delete_workflow`` so reminder FK constraints are satisfied and scheduled
+worker jobs for this workflow never fire after deletion.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.workflow_id` | `integer` | yes | Workflow integer ID. |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deleteWorkflow({ path: { workflow_id: 1 } });
+```
+
+---
+
+<a id="op-deselectcalendar"></a>
+
+### `g8.api.appointments.deselectCalendar(input)`
+
+**Deselect a sub-calendar from conflict checking**
+
+- HTTP: `DELETE /api/v1/appointments/calendars/selected`
+- operationId: `deselect_calendar_appointments_calendars_selected_delete` (also callable as `g8.api.call("deselect_calendar_appointments_calendars_selected_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Remove a sub-calendar from the caller's conflict-checking set.
+Reuses the in-app deselect_calendar logic (delete_selected_calendar).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.credential_id` | `integer` | yes |  |
+| `query.integration` | `string` | yes |  |
+| `query.external_id` | `string` | yes |  |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.deselectCalendar({
+  query: { credential_id: 123, integration: "example", external_id: "id" },
+});
+```
+
+---
+
+<a id="op-disconnectcalendar"></a>
+
+### `g8.api.appointments.disconnectCalendar(input)`
+
+**Disconnect a calendar account**
+
+- HTTP: `DELETE /api/v1/appointments/calendars/{credential_id}`
+- operationId: `disconnect_calendar_appointments_calendars__credential_id__delete` (also callable as `g8.api.call("disconnect_calendar_appointments_calendars__credential_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Disconnect a calendar account with best-effort token revocation.
+Reuses the in-app disconnect_calendar logic (revoke + delete credential +
+clean up destination calendar rows pointing at the removed credential).
+Raises 404 when not found; 403 when it belongs to a different user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.credential_id` | `integer` | yes |  |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.disconnectCalendar({ path: { credential_id: 123 } });
+```
+
+---
+
+<a id="op-disconnectconferencing"></a>
+
+### `g8.api.appointments.disconnectConferencing(input)`
+
+**Disconnect a conferencing provider**
+
+- HTTP: `DELETE /api/v1/appointments/conferencing/{provider}/disconnect`
+- operationId: `disconnect_conferencing_appointments_conferencing__provider__disconnect_delete` (also callable as `g8.api.call("disconnect_conferencing_appointments_conferencing__provider__disconnect_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Disconnect a conferencing provider. For real-credential providers
+(zoom, roam, whereby, jitsi, office365_video, roam_auto) this deletes
+the matching credentials row. Google Meet is special: it is a synthetic
+provider - disconnect sets google_meet_suppressed and clears the default
+if it pointed at Meet. Reuses the in-app disconnect_conferencing logic.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `string` | yes |  |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.disconnectConferencing({ path: { provider: "example" } });
+```
+
+---
+
+<a id="op-duplicateeventtype"></a>
+
+### `g8.api.appointments.duplicateEventType(input)`
+
+**Duplicate an event type (with a '-copy' slug)**
+
+- HTTP: `POST /api/v1/appointments/event-types/{event_type_id}/duplicate`
+- operationId: `duplicate_event_type_appointments_event_types__event_type_id__duplicate_post` (also callable as `g8.api.call("duplicate_event_type_appointments_event_types__event_type_id__duplicate_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Duplicate an event type, generating a unique ``{slug}-copy`` slug and
+copying its hosts. Mirrors the in-app duplicate path (repo-direct, no
+handler) using the shared appointments helpers; ``is_admin`` is forced False
+so a host (or the owner) can duplicate, matching ``EventTypePolicy``.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Source event-type integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.duplicateEventType({ path: { event_type_id: 1 } });
+```
+
+---
+
+<a id="op-duplicateroutingform"></a>
+
+### `g8.api.appointments.duplicateRoutingForm(input)`
+
+**Duplicate a routing form (copy with all fields and routes)**
+
+- HTTP: `POST /api/v1/appointments/routing-forms/{form_id}/duplicate`
+- operationId: `duplicate_routing_form_appointments_routing_forms__form_id__duplicate_post` (also callable as `g8.api.call("duplicate_routing_form_appointments_routing_forms__form_id__duplicate_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Duplicate a routing form. Creates a copy named "{name} (copy)" with
+a unique slug, copying all fields and routes verbatim.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Source routing form integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.duplicateRoutingForm({ path: { form_id: 1 } });
+```
+
+---
+
+<a id="op-exportbookinginsights"></a>
+
+### `g8.api.appointments.exportBookingInsights(input?)`
+
+**Export Booking Insights**
+
+- HTTP: `GET /api/v1/appointments/bookings/insights/export`
+- operationId: `export_booking_insights_appointments_bookings_insights_export_get` (also callable as `g8.api.call("export_booking_insights_appointments_bookings_insights_export_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The bookings behind `GET /appointments/bookings/insights`, one row each, as CSV.
+
+An Admin key sees the team (or `member_user_id`'s); anyone else sees their
+own bookings only - the same split the insights read makes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.date_from` | `string \| null` | no | ISO date. Omit for all time. |
+| `query.date_to` | `string \| null` | no | ISO date. Omit for all time. |
+| `query.event_type_ids` | `string \| null` | no | CSV of INTEGER event type ids. Checked here because the app splits and `int()`s it unguarded. |
+| `query.member_user_id` | `integer \| null` | no | One member's bookings. Honoured for Admin keys only. |
+
+**Returns** `ApiResponse_CsvExportPayload_`: the envelope `{ data: CsvExportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CsvExportPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `csv` | `string` | yes | The full CSV document, header row first. |
+| `filename` | `string` | yes |  |
+| `content_type` | `"text/csv"` | no | default `"text/csv"` |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.exportBookingInsights();
+```
+
+---
+
+<a id="op-exportroutingformresponses"></a>
+
+### `g8.api.appointments.exportRoutingFormResponses(input)`
+
+**Export Routing Form Responses**
+
+- HTTP: `GET /api/v1/appointments/routing-forms/{form_id}/responses/export`
+- operationId: `export_routing_form_responses_appointments_routing_forms__form_id__responses_export_get` (also callable as `g8.api.call("export_routing_form_responses_appointments_routing_forms__form_id__responses_export_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Every response to a routing form, as CSV - one column per field.
+
+The paged JSON read is `GET /appointments/routing-forms/{id}/responses`.
+Capped at the app's 10,000 most recent responses. A form you cannot see
+is a 404, not a 403, so its existence is not disclosed.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Routing form id. |
+
+**Returns** `ApiResponse_CsvExportPayload_`: the envelope `{ data: CsvExportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CsvExportPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `csv` | `string` | yes | The full CSV document, header row first. |
+| `filename` | `string` | yes |  |
+| `content_type` | `"text/csv"` | no | default `"text/csv"` |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.exportRoutingFormResponses({ path: { form_id: 123 } });
+```
+
+---
+
+<a id="op-getavailability"></a>
+
+### `g8.api.appointments.getAvailability(input)`
+
+**Get availability rules and overrides for a schedule**
+
+- HTTP: `GET /api/v1/appointments/schedules/{schedule_id}/availability`
+- operationId: `get_availability_appointments_schedules__schedule_id__availability_get` (also callable as `g8.api.call("get_availability_appointments_schedules__schedule_id__availability_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return the weekly recurring availability rules and date-specific overrides
+for the given schedule. Availability entries without a ``date`` are weekly
+rules; entries with a ``date`` are one-time overrides for that calendar day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getAvailability({ path: { schedule_id: 1 } });
+```
+
+---
+
+<a id="op-getavailableslots"></a>
+
+### `g8.api.appointments.getAvailableSlots(input)`
+
+**Get Available Slots**
+
+- HTTP: `GET /api/v1/appointments/slots`
+- operationId: `get_available_slots_appointments_slots_get` (also callable as `g8.api.call("get_available_slots_appointments_slots_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The bookable times for an event type, grouped by date under `slots`.
+
+The AUTHENTICATED slots read - the unauthenticated one a prospect's browser
+calls is deliberately not published (see the module docstring).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.event_type_id` | `integer` | yes | Event type to compute slots for. |
+| `query.start` | `string` | yes | Window start, ISO-8601. A bare date is read as UTC. |
+| `query.end` | `string` | yes | Window end, ISO-8601. At most 60 days after `start`. |
+| `query.time_zone` | `string \| null` | no | IANA timezone to express the slots in. |
+| `query.duration` | `integer \| null` | no | Minutes, for a multi-duration event type. Omit for its own length. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getAvailableSlots({ query: { event_type_id: 123, start: "example", end: "example" } });
+```
+
+---
+
+<a id="op-getbooking"></a>
+
+### `g8.api.appointments.getBooking(input)`
+
+**Get a single booking by UID**
+
+- HTTP: `GET /api/v1/appointments/bookings/{booking_uid}`
+- operationId: `get_booking_appointments_bookings__booking_uid__get` (also callable as `g8.api.call("get_booking_appointments_bookings__booking_uid__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return the full booking detail (attendees, references, meeting_url,
+responses, internal notes). Backed by ``BookingsHandler.handle_get``;
+raises 404 when the UID isn't visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getBooking({ path: { booking_uid: "example" } });
+```
+
+---
+
+<a id="op-getbookinginsights"></a>
+
+### `g8.api.appointments.getBookingInsights(input?)`
+
+**Get aggregated booking insights**
+
+- HTTP: `GET /api/v1/appointments/bookings/insights`
+- operationId: `get_booking_insights_appointments_bookings_insights_get` (also callable as `g8.api.call("get_booking_insights_appointments_bookings_insights_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return aggregated booking insights for the caller's org.
+
+Covers booking counts, show/no-show rates, and per-event-type breakdowns
+for the given date window.  Backed by ``BookingsHandler.handle_insights``
+(same handler as the in-app insights view).  ``is_admin`` is forced False
+so the caller sees only their own data. The in-app ``member_user_id`` filter
+is intentionally NOT exposed: it is an admin-only knob and an API key never
+holds admin, so the handler would ignore it anyway - omitting it from the
+route signature avoids the misleading "forwarded but ignored" surface.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.date_from` | `string \| null` | no | ISO date string for range start (e.g. '2026-01-01'). |
+| `query.date_to` | `string \| null` | no | ISO date string for range end (e.g. '2026-12-31'). |
+| `query.event_type_ids` | `string \| null` | no | Comma-separated event-type IDs to filter by. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getBookingInsights();
+```
+
+---
+
+<a id="op-getdefaultconferencing"></a>
+
+### `g8.api.appointments.getDefaultConferencing(input?)`
+
+**Get the current default conferencing provider**
+
+- HTTP: `GET /api/v1/appointments/conferencing/default`
+- operationId: `get_default_conferencing_appointments_conferencing_default_get` (also callable as `g8.api.call("get_default_conferencing_appointments_conferencing_default_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Get the default conferencing provider. Returns provider, credential_id,
+and link. Returns ``{data: {provider: null}}`` when none is configured.
+Reuses the in-app get_default_conferencing logic.
+
+**Input**: none.
+
+**Returns** `DefaultConferencingEnvelope`: the envelope `{ data: DefaultConferencingResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+`DefaultConferencingResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `credential_id` | `integer \| null` | no |  |
+| `link` | `string \| null` | no |  |
+| `provider` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getDefaultConferencing();
+```
+
+---
+
+<a id="op-getdestinationcalendar"></a>
+
+### `g8.api.appointments.getDestinationCalendar(input?)`
+
+**Get the destination calendar (with event-type fallback)**
+
+- HTTP: `GET /api/v1/appointments/calendars/destination`
+- operationId: `get_destination_calendar_appointments_calendars_destination_get` (also callable as `g8.api.call("get_destination_calendar_appointments_calendars_destination_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Get the destination calendar for the caller. When ``event_type_id`` is
+provided, returns the event-type-specific override if one exists, falling
+back to the user-level default. Returns ``{data: null}`` when none is set.
+Reuses the in-app get_destination_calendar logic.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.event_type_id` | `integer \| null` | no |  |
+
+**Returns** `DestinationCalendarEnvelope`: the envelope `{ data: DestinationCalendarResponse | null, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+`data` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `external_id` | `string` | yes |  |
+| `id` | `integer` | yes |  |
+| `integration` | `string` | yes |  |
+| `credential_id` | `integer \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `primary_email` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getDestinationCalendar();
+```
+
+---
+
+<a id="op-getembedconfig"></a>
+
+### `g8.api.appointments.getEmbedConfig(input)`
+
+**Get Embed Config**
+
+- HTTP: `GET /api/v1/appointments/event-types/{event_type_id}/embed`
+- operationId: `get_embed_config_appointments_event_types__event_type_id__embed_get` (also callable as `g8.api.call("get_embed_config_appointments_event_types__event_type_id__embed_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+How the embedded booking widget for this event type is styled.
+
+Hosts of the event type and Admin keys only.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getEmbedConfig({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-geteventtype"></a>
+
+### `g8.api.appointments.getEventType(input)`
+
+**Get full detail for one bookable event type**
+
+- HTTP: `GET /api/v1/appointments/event-types/{event_type_id}`
+- operationId: `get_event_type_appointments_event_types__event_type_id__get` (also callable as `g8.api.call("get_event_type_appointments_event_types__event_type_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return the full event-type record (booking fields, locations, hosts,
+schedule, buffers, notice) — everything an agent needs before booking a
+slot. Backed by ``EventTypesHandler.handle_get`` (same handler as the
+in-app event-type detail view). Raises 404 when the id doesn't exist in
+this org.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event-type integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getEventType({ path: { event_type_id: 1 } });
+```
+
+---
+
+<a id="op-geteventtypedestinationcalendar"></a>
+
+### `g8.api.appointments.getEventTypeDestinationCalendar(input)`
+
+**Get Event Type Destination Calendar**
+
+- HTTP: `GET /api/v1/appointments/event-types/{event_type_id}/destination-calendar`
+- operationId: `get_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_get` (also callable as `g8.api.call("get_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Where bookings for THIS event type are written.
+
+The per-event-type OVERRIDE of `GET /appointments/calendars/destination`.
+Null fields mean no override is set and the account default applies.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getEventTypeDestinationCalendar({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-geteventtypeselectedcalendars"></a>
+
+### `g8.api.appointments.getEventTypeSelectedCalendars(input)`
+
+**Get Event Type Selected Calendars**
+
+- HTTP: `GET /api/v1/appointments/event-types/{event_type_id}/selected-calendars`
+- operationId: `get_event_type_selected_calendars_appointments_event_types__event_type_id__selected_calendars_get` (also callable as `g8.api.call("get_event_type_selected_calendars_appointments_event_types__event_type_id__selected_calendars_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Which calendars are checked for conflicts on this event type.
+
+The read to reach for when a slot was offered that should not have been:
+a calendar missing from here is a calendar nobody checked.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getEventTypeSelectedCalendars({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-getorgsettings"></a>
+
+### `g8.api.appointments.getOrgSettings(input?)`
+
+**Get Org Settings**
+
+- HTTP: `GET /api/v1/appointments/org-settings`
+- operationId: `get_org_settings_appointments_org_settings_get` (also callable as `g8.api.call("get_org_settings_appointments_org_settings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The branding the public booking page wears, defaults filled in.
+
+**Input**: none.
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getOrgSettings();
+```
+
+---
+
+<a id="op-getroutingform"></a>
+
+### `g8.api.appointments.getRoutingForm(input)`
+
+**Get a single routing form**
+
+- HTTP: `GET /api/v1/appointments/routing-forms/{form_id}`
+- operationId: `get_routing_form_appointments_routing_forms__form_id__get` (also callable as `g8.api.call("get_routing_form_appointments_routing_forms__form_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return a routing form with its fields, routes, and response_count.
+
+Returns 404 when the form does not exist or belongs to another user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Routing form integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getRoutingForm({ path: { form_id: 1 } });
+```
+
+---
+
+<a id="op-getschedule"></a>
+
+### `g8.api.appointments.getSchedule(input)`
+
+**Get a schedule with availability and linked event types**
+
+- HTTP: `GET /api/v1/appointments/schedules/{schedule_id}`
+- operationId: `get_schedule_appointments_schedules__schedule_id__get` (also callable as `g8.api.call("get_schedule_appointments_schedules__schedule_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return a schedule's full detail: weekly availability rules, date overrides,
+owner info, and the list of event types currently linked to this schedule.
+Returns 404 when the schedule doesn't exist or belongs to another user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getSchedule({ path: { schedule_id: 1 } });
+```
+
+---
+
+<a id="op-getscheduleprofile"></a>
+
+### `g8.api.appointments.getScheduleProfile(input?)`
+
+**Get Schedule Profile**
+
+- HTTP: `GET /api/v1/appointments/profile`
+- operationId: `get_schedule_profile_appointments_profile_get` (also callable as `g8.api.call("get_schedule_profile_appointments_profile_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The scheduling profile of the person who minted this key.
+
+Published as `/profile` rather than the app's `/me`: an organisation key
+has no person behind it, so `/me` would promise something it cannot give.
+The first read seeds the profile with defaults if it does not exist yet.
+
+**Input**: none.
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getScheduleProfile();
+```
+
+---
+
+<a id="op-getworkflow"></a>
+
+### `g8.api.appointments.getWorkflow(input)`
+
+**Get a single workflow**
+
+- HTTP: `GET /api/v1/appointments/workflows/{workflow_id}`
+- operationId: `get_workflow_appointments_workflows__workflow_id__get` (also callable as `g8.api.call("get_workflow_appointments_workflows__workflow_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Return the full workflow record (steps, linked event types, trigger config).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.workflow_id` | `integer` | yes | Workflow integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.getWorkflow({ path: { workflow_id: 1 } });
+```
+
+---
+
+<a id="op-importmeeting"></a>
+
+### `g8.api.appointments.importMeeting(input)`
+
+**Import Meeting**
+
+- HTTP: `POST /api/v1/appointments/bookings/import`
+- operationId: `import_meeting_appointments_bookings_import_post` (also callable as `g8.api.call("import_meeting_appointments_bookings_import_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Pull a meeting booked OUTSIDE graph8 into the bookings list.
+
+For the meeting somebody put straight into their calendar. The event must
+be on a calendar the key owner connected; its details are re-read from
+there. IDEMPOTENT: importing the same event twice returns the first
+booking rather than creating a second.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ImportMeetingRequest` | yes | Request body; fields below. |
+
+Body fields (`ImportMeetingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.calendar_id` | `string` | yes |  |
+| `body.event_id` | `string` | yes |  |
+| `body.event_type_id` | `integer` | yes | The graph8 event type to import it as. |
+| `body.provider` | `"google_calendar" \| "office365_calendar"` | yes |  |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.importMeeting({
+  body: {
+    calendar_id: "id",
+    event_id: "id",
+    event_type_id: 123,
+    provider: "google_calendar",
+  },
+});
+```
+
+---
+
+<a id="op-listbookings"></a>
+
+### `g8.api.appointments.listBookings(input?)`
+
+**List the caller's bookings (paginated)**
+
+- HTTP: `GET /api/v1/appointments/bookings`
+- operationId: `list_bookings_appointments_bookings_get` (also callable as `g8.api.call("list_bookings_appointments_bookings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List bookings visible to the caller.
+
+Personal keys retain the member-scoped path. An organization key that
+passed the existing explicit ``meetings:read`` gate uses the handler's
+org-wide read path and therefore never looks up the synthetic API identity.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.status` | `string \| null` | no | Filter by status: accepted \| pending \| cancelled \| rejected. |
+| `query.event_type_id` | `integer \| null` | no | Only bookings for this event type. |
+| `query.after_start` | `string \| null` | no | ISO-8601 lower bound on start_time. |
+| `query.before_end` | `string \| null` | no | ISO-8601 upper bound on end_time. |
+| `query.attendee_email` | `string \| null` | no | Filter by an attendee email. |
+| `query.sort_by` | `string` | no | start_time \| end_time \| created_at \| status. default `"start_time"` |
+| `query.sort_order` | `string` | no | default `"desc"` |
+| `query.skip` | `integer` | no | default `0` |
+| `query.take` | `integer` | no | default `20` |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listBookings();
+```
+
+---
+
+<a id="op-listcalendarevents"></a>
+
+### `g8.api.appointments.listCalendarEvents(input)`
+
+**List Calendar Events**
+
+- HTTP: `GET /api/v1/appointments/calendars/events`
+- operationId: `list_calendar_events_appointments_calendars_events_get` (also callable as `g8.api.call("list_calendar_events_appointments_calendars_events_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+What is already on the connected Google / Outlook calendars in a window.
+
+This is what makes a slot unavailable, so it is the read to reach for when
+availability looks wrong. READ-ONLY and display-only: private events come
+back as "Busy" blocks, and a calendar that fails to load is reported in
+`errors` rather than failing the request.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.start` | `string (date-time)` | yes | Window start, ISO-8601. |
+| `query.end` | `string (date-time)` | yes | Window end, ISO-8601. |
+| `query.scope` | `"my" \| "org"` | no | `my` for the key owner alone, `org` for every member who has not opted out. An empty `org` result means nobody shares a calendar, not that nobody is busy. default `"my"` |
+| `query.host_emails` | `string \| null` | no | CSV. Narrows `org` scope to these members. |
+
+**Returns** `ApiResponse_SchedulingListPayload_`: the envelope `{ data: SchedulingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SchedulingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listCalendarEvents({
+  query: { start: "2026-01-01T09:00:00Z", end: "2026-01-01T09:00:00Z" },
+});
+```
+
+---
+
+<a id="op-listcalendars"></a>
+
+### `g8.api.appointments.listCalendars(input?)`
+
+**List connected calendar accounts**
+
+- HTTP: `GET /api/v1/appointments/calendars`
+- operationId: `list_calendars_appointments_calendars_get` (also callable as `g8.api.call("list_calendars_appointments_calendars_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List calendar accounts (Google, Outlook) connected to the caller's
+appointments profile, each with its sub-calendars and selection state.
+Reuses the in-app list_calendars logic faithfully.
+
+**Input**: none.
+
+**Returns** `Array<ConnectedCalendarResponse>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listCalendars();
+```
+
+---
+
+<a id="op-listconferencing"></a>
+
+### `g8.api.appointments.listConferencing(input?)`
+
+**List connected conferencing providers**
+
+- HTTP: `GET /api/v1/appointments/conferencing`
+- operationId: `list_conferencing_appointments_conferencing_get` (also callable as `g8.api.call("list_conferencing_appointments_conferencing_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List conferencing providers connected to the caller's appointments profile.
+Google Meet is synthesized from any google_calendar credential (it has no
+real credential row) and is suppressed when google_meet_suppressed is set.
+Reuses the in-app list_conferencing logic faithfully.
+
+**Input**: none.
+
+**Returns** `Array<ConnectedConferencingResponse>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listConferencing();
+```
+
+---
+
+<a id="op-listeventtypehostgroups"></a>
+
+### `g8.api.appointments.listEventTypeHostGroups(input)`
+
+**List Event Type Host Groups**
+
+- HTTP: `GET /api/v1/appointments/event-types/{event_type_id}/host-groups`
+- operationId: `list_event_type_host_groups_appointments_event_types__event_type_id__host_groups_get` (also callable as `g8.api.call("list_event_type_host_groups_appointments_event_types__event_type_id__host_groups_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Groups that partition this event type's hosts for the rotation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+
+**Returns** `ApiResponse_list_AppointmentHostGroup__`: the envelope `{ data: Array<AppointmentHostGroup>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`AppointmentHostGroup` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `created_at` | `string (date-time) \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listEventTypeHostGroups({ path: { event_type_id: 123 } });
+```
+
+---
+
+<a id="op-listmembership"></a>
+
+### `g8.api.appointments.listMembership(input?)`
+
+**List Membership**
+
+- HTTP: `GET /api/v1/appointments/membership`
+- operationId: `list_membership_appointments_membership_get` (also callable as `g8.api.call("list_membership_appointments_membership_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Everyone in the organisation, as scheduling sees them.
+
+The source of the integer `user_id` the member and role routes take.
+
+**Input**: none.
+
+**Returns** `ApiResponse_SchedulingListPayload_`: the envelope `{ data: SchedulingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SchedulingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listMembership();
+```
+
+---
+
+<a id="op-listooo"></a>
+
+### `g8.api.appointments.listOoo(input?)`
+
+**List out-of-office entries for the calling user**
+
+- HTTP: `GET /api/v1/appointments/out-of-office`
+- operationId: `list_ooo_appointments_out_of_office_get` (also callable as `g8.api.call("list_ooo_appointments_out_of_office_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List all out-of-office entries belonging to the calling user. API keys
+never receive org-wide admin access, so this always returns only the
+caller's own entries (equivalent to the non-admin in-app path).
+
+**Input**: none.
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listOoo();
+```
+
+---
+
+<a id="op-listroutingformresponses"></a>
+
+### `g8.api.appointments.listRoutingFormResponses(input)`
+
+**List captured responses for a routing form (paginated)**
+
+- HTTP: `GET /api/v1/appointments/routing-forms/{form_id}/responses`
+- operationId: `list_routing_form_responses_appointments_routing_forms__form_id__responses_get` (also callable as `g8.api.call("list_routing_form_responses_appointments_routing_forms__form_id__responses_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List captured form responses. Paginated via ``skip`` / ``take``.
+
+Returns 404 when the form does not exist or belongs to another user.
+Response items include: ``id``, ``form_id``, ``responses`` (field answers),
+``routed_to_event_type_id``, and ``created_at``.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Routing form integer ID. |
+| `query.skip` | `integer` | no | Number of responses to skip. default `0` |
+| `query.take` | `integer` | no | Maximum responses to return (max 500). default `50` |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listRoutingFormResponses({ path: { form_id: 1 } });
+```
+
+---
+
+<a id="op-listroutingforms"></a>
+
+### `g8.api.appointments.listRoutingForms(input?)`
+
+**List routing forms (includes response_count)**
+
+- HTTP: `GET /api/v1/appointments/routing-forms`
+- operationId: `list_routing_forms_appointments_routing_forms_get` (also callable as `g8.api.call("list_routing_forms_appointments_routing_forms_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List all routing forms owned by the API-key user.
+
+``is_admin`` is forced False - returns only the caller's own forms.
+Each item includes ``response_count`` (total submissions captured).
+
+**Input**: none.
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listRoutingForms();
+```
+
+---
+
+<a id="op-listsavedfilters"></a>
+
+### `g8.api.appointments.listSavedFilters(input?)`
+
+**List Saved Filters**
+
+- HTTP: `GET /api/v1/appointments/saved-filters`
+- operationId: `list_saved_filters_appointments_saved_filters_get` (also callable as `g8.api.call("list_saved_filters_appointments_saved_filters_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The caller's saved views over the bookings list.
+
+**Input**: none.
+
+**Returns** `ApiResponse_SchedulingListPayload_`: the envelope `{ data: SchedulingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SchedulingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listSavedFilters();
+```
+
+---
+
+<a id="op-listschedules"></a>
+
+### `g8.api.appointments.listSchedules(input?)`
+
+**List the caller's availability schedules**
+
+- HTTP: `GET /api/v1/appointments/schedules`
+- operationId: `list_schedules_appointments_schedules_get` (also callable as `g8.api.call("list_schedules_appointments_schedules_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List the caller's appointment availability schedules (the "when am I
+free?" working-hours profiles used by event types). This is DISTINCT from
+the sequencer send-window schedules at ``GET /schedules`` - those drive
+email send timing, these drive bookability. Each schedule carries its weekly
+rules' owner + a ``is_default`` flag derived from the caller's settings.
+
+**Input**: none.
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listSchedules();
+```
+
+---
+
+<a id="op-listsequencesforpicker"></a>
+
+### `g8.api.appointments.listSequencesForPicker(input?)`
+
+**List Sequences For Picker**
+
+- HTTP: `GET /api/v1/appointments/bookings/sequences-picker`
+- operationId: `list_sequences_for_picker_appointments_bookings_sequences_picker_get` (also callable as `g8.api.call("list_sequences_for_picker_appointments_bookings_sequences_picker_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Sequences a booking can be attributed to (`PATCH .../bookings/{uid}/sequence`).
+
+SCOPED by the same sequence visibility the sequencer list uses, so two
+keys can legitimately get different lists. Archived and draft sequences
+are left out.
+
+**Input**: none.
+
+**Returns** `ApiResponse_SchedulingListPayload_`: the envelope `{ data: SchedulingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SchedulingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listSequencesForPicker();
+```
+
+---
+
+<a id="op-listteamavailability"></a>
+
+### `g8.api.appointments.listTeamAvailability(input)`
+
+**List Team Availability**
+
+- HTTP: `GET /api/v1/appointments/availability/team`
+- operationId: `list_team_availability_appointments_availability_team_get` (also callable as `g8.api.call("list_team_availability_appointments_availability_team_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Every teammate's availability windows for one day.
+
+Cursor-paged on user id rather than offset, so a team that changes between
+pages does not shift rows under you. An empty `date_ranges` means that
+person has not set up a schedule, not that they are fully booked.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.date` | `string` | yes | The day, `YYYY-MM-DD`. |
+| `query.viewer_tz` | `string` | no | IANA timezone. INFORMATIONAL - the windows come back in UTC and the caller renders them; this shifts nothing server-side. default `"UTC"` |
+| `query.limit` | `integer` | no | default `50` |
+| `query.cursor` | `integer \| null` | no | `next_cursor` from the previous page. |
+| `query.search` | `string \| null` | no | Name or email substring. |
+| `query.user_ids` | `Array<integer> \| null` | no | Only these teammates. REPEATABLE (`?user_ids=1&user_ids=2`), and it takes PRECEDENCE over `search` - sending both ignores the search. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listTeamAvailability({ query: { date: "example" } });
+```
+
+---
+
+<a id="op-listworkflows"></a>
+
+### `g8.api.appointments.listWorkflows(input?)`
+
+**List all workflows**
+
+- HTTP: `GET /api/v1/appointments/workflows`
+- operationId: `list_workflows_appointments_workflows_get` (also callable as `g8.api.call("list_workflows_appointments_workflows_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+List all workflows for the organisation.
+
+**Input**: none.
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.listWorkflows();
+```
+
+---
+
+<a id="op-markabsent"></a>
+
+### `g8.api.appointments.markAbsent(input)`
+
+**Mark host or attendees as no-show**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/mark-absent`
+- operationId: `mark_absent_appointments_bookings__booking_uid__mark_absent_post` (also callable as `g8.api.call("mark_absent_appointments_bookings__booking_uid__mark_absent_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Record a no-show for the host, one or more attendees, or both.
+
+Pass ``host=true`` to flag the host as absent.  Pass ``attendees`` as a
+list of attendee dicts (each containing at least ``email``) to flag
+specific attendees.  Backed by ``BookingsHandler.handle_mark_absent``
+(updates ``no_show`` flags; sends no automatic notifications - this is
+an operator CRM action).  Raises 404 when the booking uid is not visible
+to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `MarkAbsentRequest` | yes | Request body; fields below. |
+
+Body fields (`MarkAbsentRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.attendees` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.host` | `boolean \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.markAbsent({ path: { booking_uid: "example" }, body: {} });
+```
+
+---
+
+<a id="op-releaseslot"></a>
+
+### `g8.api.appointments.releaseSlot(input)`
+
+**Release Slot**
+
+- HTTP: `DELETE /api/v1/appointments/slots/reserve/{slot_uid}`
+- operationId: `release_slot_appointments_slots_reserve__slot_uid__delete` (also callable as `g8.api.call("release_slot_appointments_slots_reserve__slot_uid__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Give a held slot back before its hold lapses. Only the holder can.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.slot_uid` | `string` | yes | The `uid` returned by `POST /appointments/slots/reserve`. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.releaseSlot({ path: { slot_uid: "example" } });
+```
+
+---
+
+<a id="op-removeeventtypehost"></a>
+
+### `g8.api.appointments.removeEventTypeHost(input)`
+
+**Remove Event Type Host**
+
+- HTTP: `DELETE /api/v1/appointments/event-types/{event_type_id}/hosts/{host_user_id}`
+- operationId: `remove_event_type_host_appointments_event_types__event_type_id__hosts__host_user_id__delete` (also callable as `g8.api.call("remove_event_type_host_appointments_event_types__event_type_id__hosts__host_user_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Remove a host. Existing bookings already assigned to them are NOT
+reassigned - this only changes who future bookings can land on.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `path.host_user_id` | `integer` | yes | Host user id. |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.removeEventTypeHost({ path: { event_type_id: 123, host_user_id: 123 } });
+```
+
+---
+
+<a id="op-requestbookingreschedule"></a>
+
+### `g8.api.appointments.requestBookingReschedule(input)`
+
+**Send a reschedule-request email to the attendee (host action)**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/request-reschedule`
+- operationId: `request_booking_reschedule_appointments_bookings__booking_uid__request_reschedule_post` (also callable as `g8.api.call("request_booking_reschedule_appointments_bookings__booking_uid__request_reschedule_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Ask the attendee to pick a new time.
+
+Sends a reschedule-request email with the optional host ``reason``
+message and a link to the public booking page.  Does NOT move or cancel
+the original booking - the attendee reschedules by clicking the link.
+Backed by ``BookingsHandler.handle_request_reschedule``.  Raises 404
+when the booking uid is not visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `RequestRescheduleRequest` | yes | Request body; fields below. |
+
+Body fields (`RequestRescheduleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.reason` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.requestBookingReschedule({ path: { booking_uid: "example" }, body: {} });
+```
+
+---
+
+<a id="op-reschedulebooking"></a>
+
+### `g8.api.appointments.rescheduleBooking(input)`
+
+**Reschedule a booking to a new start time**
+
+- HTTP: `POST /api/v1/appointments/bookings/{booking_uid}/reschedule`
+- operationId: `reschedule_booking_appointments_bookings__booking_uid__reschedule_post` (also callable as `g8.api.call("reschedule_booking_appointments_bookings__booking_uid__reschedule_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Reschedule a booking to ``start_time``. Reuses
+``BookingsHandler.handle_reschedule`` (no double credit charge — reschedules
+are free; re-renders the title, updates the calendar event, notifies
+attendees). Returns the NEW booking detail.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes |  |
+| `body` | `RescheduleBookingRequest` | yes | Request body; fields below. |
+
+Body fields (`RescheduleBookingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.start_time` | `string` | yes |  |
+| `body.rescheduling_reason` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.rescheduleBooking({ path: { booking_uid: "example" }, body: { start_time: "example" } });
+```
+
+---
+
+<a id="op-reserveslot"></a>
+
+### `g8.api.appointments.reserveSlot(input)`
+
+**Reserve Slot**
+
+- HTTP: `POST /api/v1/appointments/slots/reserve`
+- operationId: `reserve_slot_appointments_slots_reserve_post` (also callable as `g8.api.call("reserve_slot_appointments_slots_reserve_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Hold a slot for ten minutes while a booker fills in the form.
+
+NOT a booking: nothing is written to a calendar and nobody is notified.
+The hold lapses by itself at `release_at`; release it explicitly if you
+know the booker walked away. A slot already taken is a 409.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ReserveSlotRequest` | yes | Request body; fields below. |
+
+Body fields (`ReserveSlotRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.event_type_id` | `integer` | yes |  |
+| `body.slot_end` | `string` | yes | ISO-8601 end of the slot being held. |
+| `body.slot_start` | `string` | yes | ISO-8601 start of the slot being held. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.reserveSlot({
+  body: { event_type_id: 123, slot_end: "example", slot_start: "example" },
+});
+```
+
+---
+
+<a id="op-selectcalendar"></a>
+
+### `g8.api.appointments.selectCalendar(input)`
+
+**Select a sub-calendar for conflict checking**
+
+- HTTP: `POST /api/v1/appointments/calendars/selected`
+- operationId: `select_calendar_appointments_calendars_selected_post` (also callable as `g8.api.call("select_calendar_appointments_calendars_selected_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Add a sub-calendar to the caller's conflict-checking set.
+Reuses the in-app select_calendar logic (credential ownership check +
+create_selected_calendar). Raises 404 when the credential is not found
+or does not belong to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `SelectCalendarRequest` | yes | Request body; fields below. |
+
+Body fields (`SelectCalendarRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.credential_id` | `integer` | yes |  |
+| `body.external_id` | `string` | yes |  |
+| `body.integration` | `string` | yes |  |
+
+**Returns** `SelectedCalendarEnvelope`: the envelope `{ data: SelectedCalendarResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+`SelectedCalendarResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `external_id` | `string` | yes |  |
+| `id` | `string` | yes |  |
+| `integration` | `string` | yes |  |
+| `credential_id` | `integer \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.selectCalendar({
+  body: { credential_id: 123, external_id: "id", integration: "example" },
+});
+```
+
+---
+
+<a id="op-setdefaultconferencing"></a>
+
+### `g8.api.appointments.setDefaultConferencing(input)`
+
+**Set the default conferencing provider**
+
+- HTTP: `POST /api/v1/appointments/conferencing/{provider}/default`
+- operationId: `set_default_conferencing_appointments_conferencing__provider__default_post` (also callable as `g8.api.call("set_default_conferencing_appointments_conferencing__provider__default_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Set the default conferencing provider for new meetings. For link-based
+providers (roam, whereby, jitsi) a meeting URL is required (either in the
+request or previously stored on the credential). Reuses the in-app
+set_default_conferencing logic.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `string` | yes |  |
+| `body` | `SetDefaultConferencingRequest` | yes | Request body; fields below. |
+
+Body fields (`SetDefaultConferencingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.credential_id` | `integer \| null` | no |  |
+| `body.link` | `string \| null` | no |  |
+
+**Returns** `DefaultConferencingEnvelope`: the envelope `{ data: DefaultConferencingResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+`DefaultConferencingResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `credential_id` | `integer \| null` | no |  |
+| `link` | `string \| null` | no |  |
+| `provider` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.setDefaultConferencing({ path: { provider: "example" }, body: {} });
+```
+
+---
+
+<a id="op-setdefaultschedule"></a>
+
+### `g8.api.appointments.setDefaultSchedule(input)`
+
+**Set a schedule as the caller's default**
+
+- HTTP: `POST /api/v1/appointments/schedules/{schedule_id}/set-default`
+- operationId: `set_default_schedule_appointments_schedules__schedule_id__set_default_post` (also callable as `g8.api.call("set_default_schedule_appointments_schedules__schedule_id__set_default_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Mark a schedule as the caller's default availability schedule.
+
+Persists via ``repo.update_appointment_settings(default_schedule_id=...)``
+which is identical to the in-app ``PATCH /me`` (profile router) path that
+sets ``default_schedule_id``. The default schedule is used for slot
+generation when an event type has no schedule attached (Layer 3 resolution).
+Returns 404 when the schedule does not exist or belongs to another user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.setDefaultSchedule({ path: { schedule_id: 1 } });
+```
+
+---
+
+<a id="op-setdestinationcalendar"></a>
+
+### `g8.api.appointments.setDestinationCalendar(input)`
+
+**Set the destination calendar for new booking events**
+
+- HTTP: `PUT /api/v1/appointments/calendars/destination`
+- operationId: `set_destination_calendar_appointments_calendars_destination_put` (also callable as `g8.api.call("set_destination_calendar_appointments_calendars_destination_put", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Set (upsert) the destination calendar where booking events are pushed.
+Optionally scoped to a specific event type via ``event_type_id``. Reuses
+the in-app set_destination_calendar logic (upsert_destination_calendar).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `SetDestinationCalendarRequest` | yes | Request body; fields below. |
+
+Body fields (`SetDestinationCalendarRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.external_id` | `string` | yes |  |
+| `body.integration` | `string` | yes |  |
+| `body.credential_id` | `integer \| null` | no |  |
+| `body.event_type_id` | `integer \| null` | no |  |
+
+**Returns** `DestinationCalendarEnvelope`: the envelope `{ data: DestinationCalendarResponse | null, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+`data` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `external_id` | `string` | yes |  |
+| `id` | `integer` | yes |  |
+| `integration` | `string` | yes |  |
+| `credential_id` | `integer \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `primary_email` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.setDestinationCalendar({ body: { external_id: "id", integration: "example" } });
+```
+
+---
+
+<a id="op-seteventtypedestinationcalendar"></a>
+
+### `g8.api.appointments.setEventTypeDestinationCalendar(input)`
+
+**Set Event Type Destination Calendar**
+
+- HTTP: `PUT /api/v1/appointments/event-types/{event_type_id}/destination-calendar`
+- operationId: `set_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_put` (also callable as `g8.api.call("set_event_type_destination_calendar_appointments_event_types__event_type_id__destination_calendar_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Point one event type at a specific calendar.
+
+The credential must belong to the key owner - the app enforces that, which
+is why this cannot write bookings onto a colleague's calendar.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `UpdateDestinationCalendarRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateDestinationCalendarRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.credential_id` | `integer` | yes | The connected-calendar credential to write through. |
+| `body.external_id` | `string` | yes | The calendar's id in the provider. |
+| `body.integration` | `string` | yes | Calendar integration key, e.g. `google_calendar`. |
+| `body.primary_email` | `string \| null` | no |  |
+| `body.use_calendar_email` | `boolean` | no | Send invitations from the calendar's own address rather than the host's. default `false` |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.setEventTypeDestinationCalendar({
+  path: { event_type_id: 123 },
+  body: { credential_id: 123, external_id: "id", integration: "example" },
+});
+```
+
+---
+
+<a id="op-seteventtypeselectedcalendars"></a>
+
+### `g8.api.appointments.setEventTypeSelectedCalendars(input)`
+
+**Set Event Type Selected Calendars**
+
+- HTTP: `PUT /api/v1/appointments/event-types/{event_type_id}/selected-calendars`
+- operationId: `set_event_type_selected_calendars_appointments_event_types__event_type_id__selected_calendars_put` (also callable as `g8.api.call("set_event_type_selected_calendars_appointments_event_types__event_type_id__selected_calendars_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Set the conflict-check scope for this event type.
+
+`scope="account"` falls back to the key owner's account-wide selection
+and IGNORES `entries`. `scope="event_type"` REPLACES the per-event-type
+list with the entries sent (only `enabled` ones are kept) - so an empty
+list there means nothing is checked and every slot looks free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `UpdateSelectedCalendarsRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateSelectedCalendarsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.scope` | `"account" \| "event_type"` | yes |  |
+| `body.entries` | `Array<SelectedCalendarEntry>` | no |  |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.setEventTypeSelectedCalendars({ path: { event_type_id: 123 }, body: { scope: "account" } });
+```
+
+---
+
+<a id="op-setlockedfields"></a>
+
+### `g8.api.appointments.setLockedFields(input)`
+
+**Set Locked Fields**
+
+- HTTP: `PUT /api/v1/appointments/event-types/{event_type_id}/locked-fields`
+- operationId: `set_locked_fields_appointments_event_types__event_type_id__locked_fields_put` (also callable as `g8.api.call("set_locked_fields_appointments_event_types__event_type_id__locked_fields_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Decide which fields a managed template owns for every child copy.
+
+A locked field is read-only on the child AND is re-propagated from the
+template - so locking `length` after the fact OVERWRITES whatever each
+member had set. `propagation_notice` in the result counts the future
+bookings that touched. An empty list unlocks everything.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `SetLockedFieldsRequest` | yes | Request body; fields below. |
+
+Body fields (`SetLockedFieldsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.locked_fields` | `Array<"after_event_buffer" \| "before_event_buffer" \| "booking_fields" \| "description" \| "disable_cancelling" \| "disable_guests" \| "disable_rescheduling" \| "event_name" \| …>` | no | Fields locked on the managed template. An empty list unlocks everything. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.setLockedFields({ path: { event_type_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-setproviderlink"></a>
+
+### `g8.api.appointments.setProviderLink(input)`
+
+**Set or update a link-based conferencing provider's meeting URL**
+
+- HTTP: `PUT /api/v1/appointments/conferencing/{provider}/link`
+- operationId: `set_provider_link_appointments_conferencing__provider__link_put` (also callable as `g8.api.call("set_provider_link_appointments_conferencing__provider__link_put", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Set or update the meeting URL for a link-based conferencing provider
+(roam, whereby, jitsi). The provider must already be installed. Validates
+the URL against the provider's pattern. Reuses the in-app set_provider_link
+logic (validate + update_credential_key).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `string` | yes |  |
+| `body` | `Body_set_provider_link_appointments_conferencing__provider__link_put` | yes | Request body; fields below. |
+
+Body fields (`Body_set_provider_link_appointments_conferencing__provider__link_put`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.link` | `string` | yes |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.setProviderLink({ path: { provider: "example" }, body: { link: "example" } });
+```
+
+---
+
+<a id="op-toggleworkflow"></a>
+
+### `g8.api.appointments.toggleWorkflow(input)`
+
+**Activate or deactivate a workflow**
+
+- HTTP: `POST /api/v1/appointments/workflows/{workflow_id}/toggle`
+- operationId: `toggle_workflow_appointments_workflows__workflow_id__toggle_post` (also callable as `g8.api.call("toggle_workflow_appointments_workflows__workflow_id__toggle_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Set the workflow's active state. When deactivating (``active: false``),
+all pending reminders are cancelled first (same behaviour as the in-app
+toggle) so the reminder worker never fires steps for a disabled workflow.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.workflow_id` | `integer` | yes | Workflow integer ID. |
+| `body` | `ToggleWorkflowRequest` | yes | Request body; fields below. |
+
+Body fields (`ToggleWorkflowRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.active` | `boolean` | yes |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.toggleWorkflow({ path: { workflow_id: 1 }, body: { active: true } });
+```
+
+---
+
+<a id="op-unassignmanagedmember"></a>
+
+### `g8.api.appointments.unassignManagedMember(input)`
+
+**Unassign Managed Member**
+
+- HTTP: `DELETE /api/v1/appointments/event-types/{event_type_id}/members/{user_id}`
+- operationId: `unassign_managed_member_appointments_event_types__event_type_id__members__user_id__delete` (also callable as `g8.api.call("unassign_managed_member_appointments_event_types__event_type_id__members__user_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Take a member off a managed template.
+
+DESTRUCTIVE in a way the name understates: this HARD-DELETES that member's
+child event type, so their booking link for it stops resolving. Bookings
+already made survive, detached from any event type.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `path.user_id` | `integer` | yes | The member's integer scheduling user id. |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.unassignManagedMember({ path: { event_type_id: 123, user_id: 1 } });
+```
+
+---
+
+<a id="op-updateavailability"></a>
+
+### `g8.api.appointments.updateAvailability(input)`
+
+**Replace availability rules and/or date overrides for a schedule**
+
+- HTTP: `PATCH /api/v1/appointments/schedules/{schedule_id}/availability`
+- operationId: `update_availability_appointments_schedules__schedule_id__availability_patch` (also callable as `g8.api.call("update_availability_appointments_schedules__schedule_id__availability_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+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.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+| `body` | `UpdateAvailabilityRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateAvailabilityRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.availability` | `Array<AvailabilityInput> \| null` | no |  |
+| `body.overrides` | `Array<OverrideInput> \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateAvailability({ path: { schedule_id: 1 }, body: {} });
+```
+
+---
+
+<a id="op-updatebookinglocation"></a>
+
+### `g8.api.appointments.updateBookingLocation(input)`
+
+**Update the meeting location and notify both parties**
+
+- HTTP: `PATCH /api/v1/appointments/bookings/{booking_uid}/location`
+- operationId: `update_booking_location_appointments_bookings__booking_uid__location_patch` (also callable as `g8.api.call("update_booking_location_appointments_bookings__booking_uid__location_patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Change the meeting location for a booking and re-notify both parties.
+
+``location`` is a location key such as ``"zoom"``, ``"google_meet"``,
+``"in_person"``, or a custom URL.  Backed by
+``BookingsHandler.handle_update_location`` (updates the booking row,
+sends location-updated emails, emits an EDA event).  Raises 404 when
+the booking uid is not visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `UpdateLocationRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateLocationRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.location` | `string` | yes |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.updateBookingLocation({ path: { booking_uid: "example" }, body: { location: "example" } });
+```
+
+---
+
+<a id="op-updatebookingsequence"></a>
+
+### `g8.api.appointments.updateBookingSequence(input)`
+
+**Associate a booking with a sequence (or detach)**
+
+- HTTP: `PATCH /api/v1/appointments/bookings/{booking_uid}/sequence`
+- operationId: `update_booking_sequence_appointments_bookings__booking_uid__sequence_patch` (also callable as `g8.api.call("update_booking_sequence_appointments_bookings__booking_uid__sequence_patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Link a booking to a sequencer sequence or remove the link.
+
+``sequence_id`` is the sequence UUID (``seqsequences.id``); pass
+``null`` / omit to detach.  Writes to
+``booking.metadata_['campaignId']`` - the same field the public booking
+flow populates from ``?campaignId=`` at create time.  No EDA event is
+emitted (CRM-only action).  Backed by
+``BookingsHandler.handle_update_sequence``.  Raises 404 when the
+booking uid is not visible to the caller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.booking_uid` | `string` | yes | Booking UID (uuid string). |
+| `body` | `appointments__domain__entities__UpdateSequenceRequest` | yes | Request body; fields below. |
+
+Body fields (`appointments__domain__entities__UpdateSequenceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.sequence_id` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.updateBookingSequence({ path: { booking_uid: "example" }, body: {} });
+```
+
+---
+
+<a id="op-updateembedconfig"></a>
+
+### `g8.api.appointments.updateEmbedConfig(input)`
+
+**Update Embed Config**
+
+- HTTP: `PATCH /api/v1/appointments/event-types/{event_type_id}/embed`
+- operationId: `update_embed_config_appointments_event_types__event_type_id__embed_patch` (also callable as `g8.api.call("update_embed_config_appointments_event_types__event_type_id__embed_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Restyle the embedded booking widget. Only what you send is written.
+
+Like the org branding, this is visible to PROSPECTS rather than the team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `body` | `UpdateEmbedConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateEmbedConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.brand_color` | `string \| null` | no |  |
+| `body.brand_color_dark` | `string \| null` | no |  |
+| `body.button_position` | `string \| null` | no |  |
+| `body.button_text` | `string \| null` | no |  |
+| `body.button_text_color` | `string \| null` | no |  |
+| `body.hide_event_type_details` | `boolean \| null` | no |  |
+| `body.layout` | `string \| null` | no |  |
+| `body.theme` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateEmbedConfig({ path: { event_type_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-updateeventtype"></a>
+
+### `g8.api.appointments.updateEventType(input)`
+
+**Update an event type (partial)**
+
+- HTTP: `PATCH /api/v1/appointments/event-types/{event_type_id}`
+- operationId: `update_event_type_appointments_event_types__event_type_id__patch` (also callable as `g8.api.call("update_event_type_appointments_event_types__event_type_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Partially update an event type. Only the fields you send are changed
+(``exclude_unset`` semantics) - omit a field to leave it untouched, including
+``hidden`` (the active/visible toggle). Reuses
+``EventTypesHandler.handle_update`` (schedule-ownership guard, host policy).
+``is_admin`` is forced False.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event-type integer ID. |
+| `body` | `UpdateEventTypeRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateEventTypeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.after_event_buffer` | `integer \| null` | no |  |
+| `body.before_event_buffer` | `integer \| null` | no |  |
+| `body.booking_fields` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.default_layout` | `string \| null` | no |  |
+| `body.description` | `string \| null` | no |  |
+| `body.disable_cancelling` | `boolean \| null` | no |  |
+| `body.disable_guests` | `boolean \| null` | no |  |
+| `body.disable_rescheduling` | `boolean \| null` | no |  |
+| `body.event_color` | `string \| null` | no |  |
+| `body.event_name` | `string \| null` | no |  |
+| `body.hidden` | `boolean \| null` | no |  |
+| `body.layouts` | `Array<string> \| null` | no |  |
+| `body.length` | `integer \| null` | no |  |
+| `body.locations` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.metadata` | `Record<string, unknown> \| null` | no |  |
+| `body.minimum_booking_notice` | `integer \| null` | no |  |
+| `body.period_days` | `integer \| null` | no |  |
+| `body.period_end_date` | `string \| null` | no |  |
+| `body.period_start_date` | `string \| null` | no |  |
+| `body.period_type` | `string \| null` | no |  |
+| `body.recurring_event` | `Record<string, unknown> \| null` | no |  |
+| `body.requires_confirmation` | `boolean \| null` | no |  |
+| `body.schedule_id` | `integer \| null` | no |  |
+| `body.scheduling_type` | `string \| null` | no |  |
+| `body.seats_per_time_slot` | `integer \| null` | no |  |
+| `body.slot_interval` | `integer \| null` | no |  |
+| `body.slug` | `string \| null` | no |  |
+| `body.success_redirect_url` | `string \| null` | no |  |
+| `body.time_zone` | `string \| null` | no |  |
+| `body.title` | `string \| null` | no |  |
+| `body.use_common_schedule` | `boolean \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateEventType({ path: { event_type_id: 1 }, body: {} });
+```
+
+---
+
+<a id="op-updateeventtypehost"></a>
+
+### `g8.api.appointments.updateEventTypeHost(input)`
+
+**Update Event Type Host**
+
+- HTTP: `PATCH /api/v1/appointments/event-types/{event_type_id}/hosts/{host_user_id}`
+- operationId: `update_event_type_host_appointments_event_types__event_type_id__hosts__host_user_id__patch` (also callable as `g8.api.call("update_event_type_host_appointments_event_types__event_type_id__hosts__host_user_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Change a host's rotation settings. Omitted fields are left alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `path.host_user_id` | `integer` | yes | Host user id. |
+| `body` | `AppointmentHostUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`AppointmentHostUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.group_id` | `string \| null` | no |  |
+| `body.is_fixed` | `boolean \| null` | no |  |
+| `body.priority` | `integer \| null` | no |  |
+| `body.schedule_id` | `integer \| null` | no |  |
+| `body.weight` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_AppointmentHost_`: the envelope `{ data: AppointmentHost, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`AppointmentHost` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `avatar_url` | `string \| null` | no |  |
+| `email` | `string \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `group_id` | `string \| null` | no | Host group, if partitioned. |
+| `is_fixed` | `boolean \| null` | no | True = on EVERY booking. False = one of the round-robin rotation. This is the setting that decides who actually gets booked. |
+| `name` | `string \| null` | no |  |
+| `priority` | `integer \| null` | no | Rotation priority. |
+| `schedule_id` | `integer \| null` | no | Availability schedule this host is booked against. |
+| `user_id` | `integer \| null` | no |  |
+| `weight` | `integer \| null` | no | Relative share of the rotation. |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateEventTypeHost({ path: { event_type_id: 123, host_user_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-updateeventtypehostgroup"></a>
+
+### `g8.api.appointments.updateEventTypeHostGroup(input)`
+
+**Update Event Type Host Group**
+
+- HTTP: `PATCH /api/v1/appointments/event-types/{event_type_id}/host-groups/{group_id}`
+- operationId: `update_event_type_host_group_appointments_event_types__event_type_id__host_groups__group_id__patch` (also callable as `g8.api.call("update_event_type_host_group_appointments_event_types__event_type_id__host_groups__group_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Rename a host group.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.event_type_id` | `integer` | yes | Event type id. |
+| `path.group_id` | `string` | yes | Host group id. |
+| `body` | `AppointmentHostGroupWriteRequest` | yes | Request body; fields below. |
+
+Body fields (`AppointmentHostGroupWriteRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | Group name. min length 1 |
+
+**Returns** `ApiResponse_AppointmentHostGroup_`: the envelope `{ data: AppointmentHostGroup, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`AppointmentHostGroup` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `created_at` | `string (date-time) \| null` | no |  |
+| `event_type_id` | `integer \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateEventTypeHostGroup({
+  path: { event_type_id: 123, group_id: "id" },
+  body: { name: "Example" },
+});
+```
+
+---
+
+<a id="op-updatememberrole"></a>
+
+### `g8.api.appointments.updateMemberRole(input)`
+
+**Update Member Role**
+
+- HTTP: `PATCH /api/v1/appointments/membership/by-user/{user_id}/role`
+- operationId: `update_member_role_appointments_membership_by_user__user_id__role_patch` (also callable as `g8.api.call("update_member_role_appointments_membership_by_user__user_id__role_patch", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Change someone's SCHEDULING role. Admin keys only.
+
+This decides what they can do in scheduling, not in graph8 generally -
+organisation roles live in Settings and are not reachable from here.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.user_id` | `integer` | yes | The member's INTEGER scheduling user id - `user_id` from `GET /appointments/membership`. Not a PropelAuth id or an email. |
+| `body` | `UpdateMemberRoleRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateMemberRoleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.role` | `"ADMIN" \| "MEMBER"` | yes |  |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.appointments.updateMemberRole({ path: { user_id: 123 }, body: { role: "ADMIN" } });
+```
+
+---
+
+<a id="op-updateooo"></a>
+
+### `g8.api.appointments.updateOoo(input)`
+
+**Update an out-of-office entry**
+
+- HTTP: `PATCH /api/v1/appointments/out-of-office/{ooo_uuid}`
+- operationId: `update_ooo_appointments_out_of_office__ooo_uuid__patch` (also callable as `g8.api.call("update_ooo_appointments_out_of_office__ooo_uuid__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Update an entry owned by the calling API user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.ooo_uuid` | `string` | yes | UUID of the out-of-office entry to update. |
+| `body` | `UpdateOutOfOfficeRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateOutOfOfficeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.end` | `string \| null` | no |  |
+| `body.notes` | `string \| null` | no |  |
+| `body.public_note` | `string \| null` | no |  |
+| `body.reason` | `string \| null` | no |  |
+| `body.start` | `string \| null` | no |  |
+| `body.time_zone` | `string \| null` | no |  |
+| `body.to_user_id` | `integer \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateOoo({
+  path: { ooo_uuid: "00000000-0000-0000-0000-000000000000" },
+  body: {},
+});
+```
+
+---
+
+<a id="op-updateorgsettings"></a>
+
+### `g8.api.appointments.updateOrgSettings(input)`
+
+**Update Org Settings**
+
+- HTTP: `PATCH /api/v1/appointments/org-settings`
+- operationId: `update_org_settings_appointments_org_settings_patch` (also callable as `g8.api.call("update_org_settings_appointments_org_settings_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Change the booking page's branding. Admin keys only.
+
+Only what you send is written. This is what a PROSPECT sees, so a wrong
+value here is visible outside the organisation rather than inside it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `UpdateOrgSettingsRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateOrgSettingsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.booking_page_theme` | `"light" \| "dark" \| "auto" \| null` | no |  |
+| `body.brand_color` | `string \| null` | no | Six-digit hex including the leading `#`, e.g. `#1a2b3c`. pattern `^#[0-9a-fA-F]{6}$` |
+| `body.hide_branding` | `boolean \| null` | no | Remove the graph8 mark from the booking page. |
+| `body.logo_url` | `string (uri) \| null` | no | min length 1, max length 2083 |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateOrgSettings({ body: {} });
+```
+
+---
+
+<a id="op-updateroutingform"></a>
+
+### `g8.api.appointments.updateRoutingForm(input)`
+
+**Update a routing form (partial)**
+
+- HTTP: `PATCH /api/v1/appointments/routing-forms/{form_id}`
+- operationId: `update_routing_form_appointments_routing_forms__form_id__patch` (also callable as `g8.api.call("update_routing_form_appointments_routing_forms__form_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Partially update a routing form. Only sent fields are changed.
+
+Omit a field to leave it untouched. Slug must be unique in the org (409 on
+collision). Fields/routes are replaced atomically when present in the body.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.form_id` | `integer` | yes | Routing form integer ID. |
+| `body` | `UpdateRoutingFormRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateRoutingFormRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no |  |
+| `body.disabled` | `boolean \| null` | no |  |
+| `body.fields` | `Array<RoutingFormField> \| null` | no |  |
+| `body.name` | `string \| null` | no | min length 1, max length 255 |
+| `body.routes` | `Array<RoutingFormRouteInput> \| null` | no |  |
+| `body.slug` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateRoutingForm({ path: { form_id: 1 }, body: {} });
+```
+
+---
+
+<a id="op-updatesavedfilter"></a>
+
+### `g8.api.appointments.updateSavedFilter(input)`
+
+**Update Saved Filter**
+
+- HTTP: `PUT /api/v1/appointments/saved-filters/{filter_id}`
+- operationId: `update_saved_filter_appointments_saved_filters__filter_id__put` (also callable as `g8.api.call("update_saved_filter_appointments_saved_filters__filter_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Change a saved view.
+
+`null` LEAVES A FIELD ALONE, except `description`, where null is a real
+clear. That asymmetry is the app's and is mirrored rather than smoothed
+over, because smoothing it would make "remove the description" impossible.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.filter_id` | `string` | yes | Filter id (UUID). |
+| `body` | `UpdateSavedFilterRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateSavedFilterRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no | Null CLEARS this one, unlike the others. max length 2000 |
+| `body.state` | `Record<string, unknown> \| null` | no |  |
+| `body.title` | `string \| null` | no | min length 1, max length 120 |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateSavedFilter({ path: { filter_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateschedule"></a>
+
+### `g8.api.appointments.updateSchedule(input)`
+
+**Update a schedule (partial)**
+
+- HTTP: `PATCH /api/v1/appointments/schedules/{schedule_id}`
+- operationId: `update_schedule_appointments_schedules__schedule_id__patch` (also callable as `g8.api.call("update_schedule_appointments_schedules__schedule_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Partially update a schedule. Pass only the fields to change.
+
+- ``name`` / ``time_zone``: update schedule metadata.
+- ``availability``: replaces ALL weekly recurring rules (pass every active day).
+- ``overrides``: replaces ALL date-specific overrides.
+- ``is_default``: when True, sets this as the caller's default schedule.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.schedule_id` | `integer` | yes | Schedule integer ID. |
+| `body` | `UpdateScheduleRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateScheduleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.availability` | `Array<AvailabilityInput> \| null` | no |  |
+| `body.is_default` | `boolean \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.overrides` | `Array<OverrideInput> \| null` | no |  |
+| `body.time_zone` | `string \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateSchedule({ path: { schedule_id: 1 }, body: {} });
+```
+
+---
+
+<a id="op-updatescheduleprofile"></a>
+
+### `g8.api.appointments.updateScheduleProfile(input)`
+
+**Update Schedule Profile**
+
+- HTTP: `PATCH /api/v1/appointments/profile`
+- operationId: `update_schedule_profile_appointments_profile_patch` (also callable as `g8.api.call("update_schedule_profile_appointments_profile_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Change the key owner's scheduling preferences. Only what you send is written.
+
+`username` is the personal booking-URL slug and is GLOBALLY unique across
+graph8, claimed atomically - a rename can lose the race and come back as a
+conflict rather than succeeding quietly.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `UpdateScheduleProfileRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateScheduleProfileRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.buffer_time` | `integer \| null` | no | Minutes held either side of a booking. |
+| `body.default_schedule_id` | `integer \| null` | no |  |
+| `body.hide_calendar_from_org` | `boolean \| null` | no | Hide the caller's external calendars from teammates' org-wide overlay. |
+| `body.time_format` | `integer \| null` | no | 12 or 24. |
+| `body.time_zone` | `string \| null` | no | IANA timezone, e.g. `Europe/London`. |
+| `body.username` | `string \| null` | no | Personal booking-URL slug. GLOBALLY unique across graph8 and claimed atomically, so a rename can lose the race and come back as a conflict. |
+| `body.week_start` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_SchedulingPayload_`: the envelope `{ data: SchedulingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.appointments.updateScheduleProfile({ body: {} });
+```
+
+---
+
+<a id="op-updateworkflow"></a>
+
+### `g8.api.appointments.updateWorkflow(input)`
+
+**Update a workflow (partial)**
+
+- HTTP: `PATCH /api/v1/appointments/workflows/{workflow_id}`
+- operationId: `update_workflow_appointments_workflows__workflow_id__patch` (also callable as `g8.api.call("update_workflow_appointments_workflows__workflow_id__patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `meetings:run`
+
+Partially update a workflow. Only the fields you send are changed; omit a
+field to leave it as-is. Steps are replaced wholesale when provided.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.workflow_id` | `integer` | yes | Workflow integer ID. |
+| `body` | `UpdateWorkflowRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateWorkflowRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.event_type_ids` | `Array<integer> \| null` | no |  |
+| `body.is_active_on_all` | `boolean \| null` | no |  |
+| `body.name` | `string \| null` | no | min length 1, max length 255 |
+| `body.steps` | `Array<WorkflowStepInput> \| null` | no | min items 1, max items 20 |
+| `body.time` | `integer \| null` | no | min 1 |
+| `body.time_unit` | `"minutes" \| "hours" \| "days" \| null` | no |  |
+| `body.trigger` | `"new_booking" \| "before_event" \| "after_event" \| "booking_cancelled" \| "booking_rescheduled" \| null` | no |  |
+
+**Returns** `Record<string, unknown>`.
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.appointments.updateWorkflow({ path: { workflow_id: 1 }, body: {} });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-attendeeinput"></a>
+
+### `AttendeeInput`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `email` | `string` | yes |  |
+| `name` | `string` | yes |  |
+| `phone_number` | `string \| null` | no |  |
+| `time_zone` | `string \| null` | no |  |
+
+<a id="type-availabilityinput"></a>
+
+### `AvailabilityInput`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `days` | `Array<integer>` | yes |  |
+| `end_time` | `string` | yes |  |
+| `start_time` | `string` | yes |  |
+
+<a id="type-locationitem"></a>
+
+### `LocationItem`
+
+A single location option on an event type.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `kind` | `LocationKind` | yes |  |
+| `address` | `string \| null` | no |  |
+| `display_label` | `string \| null` | no |  |
+| `link` | `string \| null` | no |  |
+| `phone` | `string \| null` | no |  |
+| `provider` | `string \| null` | no |  |
+| `public` | `boolean` | no | default `true` |
+
+<a id="type-overrideinput"></a>
+
+### `OverrideInput`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `date` | `string` | yes |  |
+| `end_time` | `string` | yes |  |
+| `start_time` | `string` | yes |  |
+
+<a id="type-routingformfield"></a>
+
+### `RoutingFormField`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `label` | `string` | yes | min length 1, max length 500 |
+| `id` | `string \| null` | no |  |
+| `identifier` | `string \| null` | no |  |
+| `options` | `Array<RoutingFormFieldOption>` | no |  |
+| `placeholder` | `string \| null` | no |  |
+| `required` | `boolean` | no | default `true` |
+| `type` | `"text" \| "email" \| "phone" \| "number" \| "textarea" \| "select" \| "multiselect" \| "radio" \| …` | no | default `"select"` |
+
+<a id="type-routingformrouteinput"></a>
+
+### `RoutingFormRouteInput`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `action_type` | `"redirect_event_type" \| "redirect_url" \| "show_message"` | no | default `"redirect_event_type"` |
+| `action_value` | `string` | no | default `""` |
+| `conditions` | `Array<RoutingFormCondition>` | no |  |
+| `is_fallback` | `boolean` | no | default `false` |
+| `position` | `integer` | no | default `0` |
+
+<a id="type-selectedcalendarentry"></a>
+
+### `SelectedCalendarEntry`
+
+One calendar to consult when checking for conflicts.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `credential_id` | `integer` | yes |  |
+| `external_id` | `string` | yes |  |
+| `integration` | `string` | yes |  |
+| `enabled` | `boolean` | no | default `true` |
+
+<a id="type-workflowstepinput"></a>
+
+### `WorkflowStepInput`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `action` | `"email_host" \| "email_attendee" \| "email_address"` | yes |  |
+| `email_subject` | `string \| null` | no | max length 500 |
+| `include_calendar_event` | `boolean` | no | default `false` |
+| `reminder_body` | `string \| null` | no | max length 20000 |
+| `send_to` | `string (email) \| null` | no |  |
+| `sender` | `string \| null` | no | max length 255 |
+| `template` | `"reminder" \| "custom" \| "cancelled" \| "rescheduled" \| "completed" \| "rating"` | no | default `"reminder"` |