recal-sdk 1.1.0 → 1.2.0

package/dist/client/types.gen.d.ts

@@ -43,6 +43,28 @@ export type TimeRange = {
      */
     start: Date;
 };
+/**
+ * Why a calendar or a user could not be read. What each value means and how to resolve it: https://docs.recal.dev/core/troubleshooting
+ */
+export type FreeBusyFailureReason = 'accessDenied' | 'authorizationInvalid' | 'insufficientScopes' | 'invalidCalendarId' | 'mailboxUnavailable' | 'notFound' | 'providerError' | 'providerNotConfigured' | 'rateLimited' | 'tooManyCalendars';
+/**
+ * A calendar that could not be read
+ */
+export type FailedCalendar = {
+    calendarId: string;
+    message: string;
+    provider: 'google' | 'microsoft';
+    reason: FreeBusyFailureReason;
+};
+/**
+ * A user whose busy times are missing (failedCalendars empty) or incomplete (failedCalendars names the gaps)
+ */
+export type FailedFreeBusyUser = {
+    customId: string;
+    failedCalendars: Array<FailedCalendar>;
+    message: string;
+    reason: FreeBusyFailureReason;
+};
 /**
  * Recal Normalized Calendar
  */
@@ -201,7 +223,7 @@ export type GetV1OrganizationsResponses = {
 };
 export type GetV1OrganizationsResponse = GetV1OrganizationsResponses[keyof GetV1OrganizationsResponses];
 export type PostV1OrganizationsData = {
-    body?: {
+    body: {
         name: string | null;
         slug: string;
     };
@@ -210,6 +232,13 @@ export type PostV1OrganizationsData = {
     url: '/v1/organizations';
 };
 export type PostV1OrganizationsErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization with slug already exists
      */
@@ -228,7 +257,7 @@ export type PostV1OrganizationsResponses = {
     };
 };
 export type PostV1OrganizationsResponse = PostV1OrganizationsResponses[keyof PostV1OrganizationsResponses];
-export type DeleteV1OrganizationsOrgSlugData = {
+export type DeleteV1OrganizationsByOrgSlugData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -236,7 +265,14 @@ export type DeleteV1OrganizationsOrgSlugData = {
     query?: never;
     url: '/v1/organizations/{orgSlug}';
 };
-export type DeleteV1OrganizationsOrgSlugErrors = {
+export type DeleteV1OrganizationsByOrgSlugErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -245,8 +281,8 @@ export type DeleteV1OrganizationsOrgSlugErrors = {
         error: string;
     };
 };
-export type DeleteV1OrganizationsOrgSlugError = DeleteV1OrganizationsOrgSlugErrors[keyof DeleteV1OrganizationsOrgSlugErrors];
-export type DeleteV1OrganizationsOrgSlugResponses = {
+export type DeleteV1OrganizationsByOrgSlugError = DeleteV1OrganizationsByOrgSlugErrors[keyof DeleteV1OrganizationsByOrgSlugErrors];
+export type DeleteV1OrganizationsByOrgSlugResponses = {
     /**
      * Deleted organization
      */
@@ -254,8 +290,8 @@ export type DeleteV1OrganizationsOrgSlugResponses = {
         data: Organization;
     };
 };
-export type DeleteV1OrganizationsOrgSlugResponse = DeleteV1OrganizationsOrgSlugResponses[keyof DeleteV1OrganizationsOrgSlugResponses];
-export type GetV1OrganizationsOrgSlugData = {
+export type DeleteV1OrganizationsByOrgSlugResponse = DeleteV1OrganizationsByOrgSlugResponses[keyof DeleteV1OrganizationsByOrgSlugResponses];
+export type GetV1OrganizationsByOrgSlugData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -263,7 +299,14 @@ export type GetV1OrganizationsOrgSlugData = {
     query?: never;
     url: '/v1/organizations/{orgSlug}';
 };
-export type GetV1OrganizationsOrgSlugErrors = {
+export type GetV1OrganizationsByOrgSlugErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -272,8 +315,8 @@ export type GetV1OrganizationsOrgSlugErrors = {
         error: string;
     };
 };
-export type GetV1OrganizationsOrgSlugError = GetV1OrganizationsOrgSlugErrors[keyof GetV1OrganizationsOrgSlugErrors];
-export type GetV1OrganizationsOrgSlugResponses = {
+export type GetV1OrganizationsByOrgSlugError = GetV1OrganizationsByOrgSlugErrors[keyof GetV1OrganizationsByOrgSlugErrors];
+export type GetV1OrganizationsByOrgSlugResponses = {
     /**
      * Organization
      */
@@ -281,9 +324,9 @@ export type GetV1OrganizationsOrgSlugResponses = {
         data: Organization;
     };
 };
-export type GetV1OrganizationsOrgSlugResponse = GetV1OrganizationsOrgSlugResponses[keyof GetV1OrganizationsOrgSlugResponses];
-export type PutV1OrganizationsOrgSlugData = {
-    body?: {
+export type GetV1OrganizationsByOrgSlugResponse = GetV1OrganizationsByOrgSlugResponses[keyof GetV1OrganizationsByOrgSlugResponses];
+export type PutV1OrganizationsByOrgSlugData = {
+    body: {
         name: string | null;
         slug: string;
     };
@@ -293,7 +336,14 @@ export type PutV1OrganizationsOrgSlugData = {
     query?: never;
     url: '/v1/organizations/{orgSlug}';
 };
-export type PutV1OrganizationsOrgSlugErrors = {
+export type PutV1OrganizationsByOrgSlugErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -302,8 +352,8 @@ export type PutV1OrganizationsOrgSlugErrors = {
         error: string;
     };
 };
-export type PutV1OrganizationsOrgSlugError = PutV1OrganizationsOrgSlugErrors[keyof PutV1OrganizationsOrgSlugErrors];
-export type PutV1OrganizationsOrgSlugResponses = {
+export type PutV1OrganizationsByOrgSlugError = PutV1OrganizationsByOrgSlugErrors[keyof PutV1OrganizationsByOrgSlugErrors];
+export type PutV1OrganizationsByOrgSlugResponses = {
     /**
      * Updated organization
      */
@@ -311,9 +361,9 @@ export type PutV1OrganizationsOrgSlugResponses = {
         data: Organization;
     };
 };
-export type PutV1OrganizationsOrgSlugResponse = PutV1OrganizationsOrgSlugResponses[keyof PutV1OrganizationsOrgSlugResponses];
-export type DeleteV1OrganizationsOrgSlugMembersData = {
-    body?: {
+export type PutV1OrganizationsByOrgSlugResponse = PutV1OrganizationsByOrgSlugResponses[keyof PutV1OrganizationsByOrgSlugResponses];
+export type DeleteV1OrganizationsByOrgSlugMembersData = {
+    body: {
         userIds: Array<string>;
     };
     path: {
@@ -322,7 +372,14 @@ export type DeleteV1OrganizationsOrgSlugMembersData = {
     query?: never;
     url: '/v1/organizations/{orgSlug}/members';
 };
-export type DeleteV1OrganizationsOrgSlugMembersErrors = {
+export type DeleteV1OrganizationsByOrgSlugMembersErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -331,14 +388,14 @@ export type DeleteV1OrganizationsOrgSlugMembersErrors = {
         error: string;
     };
 };
-export type DeleteV1OrganizationsOrgSlugMembersError = DeleteV1OrganizationsOrgSlugMembersErrors[keyof DeleteV1OrganizationsOrgSlugMembersErrors];
-export type DeleteV1OrganizationsOrgSlugMembersResponses = {
+export type DeleteV1OrganizationsByOrgSlugMembersError = DeleteV1OrganizationsByOrgSlugMembersErrors[keyof DeleteV1OrganizationsByOrgSlugMembersErrors];
+export type DeleteV1OrganizationsByOrgSlugMembersResponses = {
     200: {
         data: string;
     };
 };
-export type DeleteV1OrganizationsOrgSlugMembersResponse = DeleteV1OrganizationsOrgSlugMembersResponses[keyof DeleteV1OrganizationsOrgSlugMembersResponses];
-export type GetV1OrganizationsOrgSlugMembersData = {
+export type DeleteV1OrganizationsByOrgSlugMembersResponse = DeleteV1OrganizationsByOrgSlugMembersResponses[keyof DeleteV1OrganizationsByOrgSlugMembersResponses];
+export type GetV1OrganizationsByOrgSlugMembersData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -348,7 +405,14 @@ export type GetV1OrganizationsOrgSlugMembersData = {
     };
     url: '/v1/organizations/{orgSlug}/members';
 };
-export type GetV1OrganizationsOrgSlugMembersErrors = {
+export type GetV1OrganizationsByOrgSlugMembersErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -357,8 +421,8 @@ export type GetV1OrganizationsOrgSlugMembersErrors = {
         error: string;
     };
 };
-export type GetV1OrganizationsOrgSlugMembersError = GetV1OrganizationsOrgSlugMembersErrors[keyof GetV1OrganizationsOrgSlugMembersErrors];
-export type GetV1OrganizationsOrgSlugMembersResponses = {
+export type GetV1OrganizationsByOrgSlugMembersError = GetV1OrganizationsByOrgSlugMembersErrors[keyof GetV1OrganizationsByOrgSlugMembersErrors];
+export type GetV1OrganizationsByOrgSlugMembersResponses = {
     /**
      * All members of an organization
      */
@@ -371,9 +435,9 @@ export type GetV1OrganizationsOrgSlugMembersResponses = {
         }>;
     };
 };
-export type GetV1OrganizationsOrgSlugMembersResponse = GetV1OrganizationsOrgSlugMembersResponses[keyof GetV1OrganizationsOrgSlugMembersResponses];
-export type PostV1OrganizationsOrgSlugMembersData = {
-    body?: {
+export type GetV1OrganizationsByOrgSlugMembersResponse = GetV1OrganizationsByOrgSlugMembersResponses[keyof GetV1OrganizationsByOrgSlugMembersResponses];
+export type PostV1OrganizationsByOrgSlugMembersData = {
+    body: {
         userIds: Array<string>;
     };
     path: {
@@ -382,7 +446,14 @@ export type PostV1OrganizationsOrgSlugMembersData = {
     query?: never;
     url: '/v1/organizations/{orgSlug}/members';
 };
-export type PostV1OrganizationsOrgSlugMembersErrors = {
+export type PostV1OrganizationsByOrgSlugMembersErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -391,8 +462,8 @@ export type PostV1OrganizationsOrgSlugMembersErrors = {
         error: string;
     };
 };
-export type PostV1OrganizationsOrgSlugMembersError = PostV1OrganizationsOrgSlugMembersErrors[keyof PostV1OrganizationsOrgSlugMembersErrors];
-export type PostV1OrganizationsOrgSlugMembersResponses = {
+export type PostV1OrganizationsByOrgSlugMembersError = PostV1OrganizationsByOrgSlugMembersErrors[keyof PostV1OrganizationsByOrgSlugMembersErrors];
+export type PostV1OrganizationsByOrgSlugMembersResponses = {
     /**
      * All users are already members of the organization
      */
@@ -406,8 +477,8 @@ export type PostV1OrganizationsOrgSlugMembersResponses = {
         data: string;
     };
 };
-export type PostV1OrganizationsOrgSlugMembersResponse = PostV1OrganizationsOrgSlugMembersResponses[keyof PostV1OrganizationsOrgSlugMembersResponses];
-export type GetV1OrganizationsOrgSlugCalendarBusyData = {
+export type PostV1OrganizationsByOrgSlugMembersResponse = PostV1OrganizationsByOrgSlugMembersResponses[keyof PostV1OrganizationsByOrgSlugMembersResponses];
+export type GetV1OrganizationsByOrgSlugCalendarBusyData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -423,13 +494,13 @@ export type GetV1OrganizationsOrgSlugCalendarBusyData = {
     };
     url: '/v1/organizations/{orgSlug}/calendar/busy';
 };
-export type GetV1OrganizationsOrgSlugCalendarBusyErrors = {
+export type GetV1OrganizationsByOrgSlugCalendarBusyErrors = {
     /**
-     * Calendar provider rejected the stored access token
+     * Bad request
      */
-    401: {
-        data: null;
+    400: {
         error: string;
+        data: null;
     };
     /**
      * Organization not found
@@ -438,25 +509,19 @@ export type GetV1OrganizationsOrgSlugCalendarBusyErrors = {
         data: null;
         error: string;
     };
-    /**
-     * Calendar provider unreachable or returned an unreadable response
-     */
-    502: {
-        data: null;
-        error: string;
-    };
 };
-export type GetV1OrganizationsOrgSlugCalendarBusyError = GetV1OrganizationsOrgSlugCalendarBusyErrors[keyof GetV1OrganizationsOrgSlugCalendarBusyErrors];
-export type GetV1OrganizationsOrgSlugCalendarBusyResponses = {
+export type GetV1OrganizationsByOrgSlugCalendarBusyError = GetV1OrganizationsByOrgSlugCalendarBusyErrors[keyof GetV1OrganizationsByOrgSlugCalendarBusyErrors];
+export type GetV1OrganizationsByOrgSlugCalendarBusyResponses = {
     /**
-     * Busy times of all users of an organization
+     * Busy times of all users of an organization, plus the users that could not be read
      */
     200: {
         data: Array<TimeRange>;
+        failedUsers: Array<FailedFreeBusyUser>;
     };
 };
-export type GetV1OrganizationsOrgSlugCalendarBusyResponse = GetV1OrganizationsOrgSlugCalendarBusyResponses[keyof GetV1OrganizationsOrgSlugCalendarBusyResponses];
-export type GetV1OrganizationsOrgSlugSchedulingData = {
+export type GetV1OrganizationsByOrgSlugCalendarBusyResponse = GetV1OrganizationsByOrgSlugCalendarBusyResponses[keyof GetV1OrganizationsByOrgSlugCalendarBusyResponses];
+export type GetV1OrganizationsByOrgSlugSchedulingData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -494,19 +559,26 @@ export type GetV1OrganizationsOrgSlugSchedulingData = {
     };
     url: '/v1/organizations/{orgSlug}/scheduling';
 };
-export type GetV1OrganizationsOrgSlugSchedulingErrors = {
+export type GetV1OrganizationsByOrgSlugSchedulingErrors = {
     /**
-     * Organization not found
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Organization not found, or it has no members
      */
     404: {
         data: null;
         error: string;
     };
 };
-export type GetV1OrganizationsOrgSlugSchedulingError = GetV1OrganizationsOrgSlugSchedulingErrors[keyof GetV1OrganizationsOrgSlugSchedulingErrors];
-export type GetV1OrganizationsOrgSlugSchedulingResponses = {
+export type GetV1OrganizationsByOrgSlugSchedulingError = GetV1OrganizationsByOrgSlugSchedulingErrors[keyof GetV1OrganizationsByOrgSlugSchedulingErrors];
+export type GetV1OrganizationsByOrgSlugSchedulingResponses = {
     /**
-     * Available time slots
+     * Available time slots, plus the users that could not be read
      */
     200: {
         data: {
@@ -549,9 +621,10 @@ export type GetV1OrganizationsOrgSlugSchedulingResponses = {
                 latestTimeEachDay?: string;
             };
         };
+        failedUsers: Array<FailedFreeBusyUser>;
     };
 };
-export type GetV1OrganizationsOrgSlugSchedulingResponse = GetV1OrganizationsOrgSlugSchedulingResponses[keyof GetV1OrganizationsOrgSlugSchedulingResponses];
+export type GetV1OrganizationsByOrgSlugSchedulingResponse = GetV1OrganizationsByOrgSlugSchedulingResponses[keyof GetV1OrganizationsByOrgSlugSchedulingResponses];
 export type GetV1UsersData = {
     body?: never;
     path?: never;
@@ -573,7 +646,7 @@ export type GetV1UsersResponses = {
 };
 export type GetV1UsersResponse = GetV1UsersResponses[keyof GetV1UsersResponses];
 export type PostV1UsersData = {
-    body?: {
+    body: {
         id: string;
         organizationSlugs?: Array<string>;
     };
@@ -582,6 +655,13 @@ export type PostV1UsersData = {
     url: '/v1/users';
 };
 export type PostV1UsersErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -612,7 +692,7 @@ export type PostV1UsersResponses = {
     };
 };
 export type PostV1UsersResponse = PostV1UsersResponses[keyof PostV1UsersResponses];
-export type DeleteV1UsersUserIdData = {
+export type DeleteV1UsersByUserIdData = {
     body?: never;
     path: {
         userId: string;
@@ -620,7 +700,14 @@ export type DeleteV1UsersUserIdData = {
     query?: never;
     url: '/v1/users/{userId}';
 };
-export type DeleteV1UsersUserIdErrors = {
+export type DeleteV1UsersByUserIdErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -629,8 +716,8 @@ export type DeleteV1UsersUserIdErrors = {
         error: string;
     };
 };
-export type DeleteV1UsersUserIdError = DeleteV1UsersUserIdErrors[keyof DeleteV1UsersUserIdErrors];
-export type DeleteV1UsersUserIdResponses = {
+export type DeleteV1UsersByUserIdError = DeleteV1UsersByUserIdErrors[keyof DeleteV1UsersByUserIdErrors];
+export type DeleteV1UsersByUserIdResponses = {
     /**
      * User
      */
@@ -643,8 +730,8 @@ export type DeleteV1UsersUserIdResponses = {
         };
     };
 };
-export type DeleteV1UsersUserIdResponse = DeleteV1UsersUserIdResponses[keyof DeleteV1UsersUserIdResponses];
-export type GetV1UsersUserIdData = {
+export type DeleteV1UsersByUserIdResponse = DeleteV1UsersByUserIdResponses[keyof DeleteV1UsersByUserIdResponses];
+export type GetV1UsersByUserIdData = {
     body?: never;
     path: {
         userId: string;
@@ -654,7 +741,14 @@ export type GetV1UsersUserIdData = {
     };
     url: '/v1/users/{userId}';
 };
-export type GetV1UsersUserIdErrors = {
+export type GetV1UsersByUserIdErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -663,8 +757,8 @@ export type GetV1UsersUserIdErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdError = GetV1UsersUserIdErrors[keyof GetV1UsersUserIdErrors];
-export type GetV1UsersUserIdResponses = {
+export type GetV1UsersByUserIdError = GetV1UsersByUserIdErrors[keyof GetV1UsersByUserIdErrors];
+export type GetV1UsersByUserIdResponses = {
     /**
      * User
      */
@@ -677,9 +771,9 @@ export type GetV1UsersUserIdResponses = {
         };
     };
 };
-export type GetV1UsersUserIdResponse = GetV1UsersUserIdResponses[keyof GetV1UsersUserIdResponses];
-export type PutV1UsersUserIdData = {
-    body?: {
+export type GetV1UsersByUserIdResponse = GetV1UsersByUserIdResponses[keyof GetV1UsersByUserIdResponses];
+export type PutV1UsersByUserIdData = {
+    body: {
         userId: string;
     };
     path: {
@@ -688,7 +782,14 @@ export type PutV1UsersUserIdData = {
     query?: never;
     url: '/v1/users/{userId}';
 };
-export type PutV1UsersUserIdErrors = {
+export type PutV1UsersByUserIdErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -704,8 +805,8 @@ export type PutV1UsersUserIdErrors = {
         error: string;
     };
 };
-export type PutV1UsersUserIdError = PutV1UsersUserIdErrors[keyof PutV1UsersUserIdErrors];
-export type PutV1UsersUserIdResponses = {
+export type PutV1UsersByUserIdError = PutV1UsersByUserIdErrors[keyof PutV1UsersByUserIdErrors];
+export type PutV1UsersByUserIdResponses = {
     /**
      * User
      */
@@ -718,8 +819,8 @@ export type PutV1UsersUserIdResponses = {
         };
     };
 };
-export type PutV1UsersUserIdResponse = PutV1UsersUserIdResponses[keyof PutV1UsersUserIdResponses];
-export type GetV1UsersUserIdOrganizationsData = {
+export type PutV1UsersByUserIdResponse = PutV1UsersByUserIdResponses[keyof PutV1UsersByUserIdResponses];
+export type GetV1UsersByUserIdOrganizationsData = {
     body?: never;
     path: {
         userId: string;
@@ -727,7 +828,14 @@ export type GetV1UsersUserIdOrganizationsData = {
     query?: never;
     url: '/v1/users/{userId}/organizations';
 };
-export type GetV1UsersUserIdOrganizationsErrors = {
+export type GetV1UsersByUserIdOrganizationsErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -736,8 +844,8 @@ export type GetV1UsersUserIdOrganizationsErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOrganizationsError = GetV1UsersUserIdOrganizationsErrors[keyof GetV1UsersUserIdOrganizationsErrors];
-export type GetV1UsersUserIdOrganizationsResponses = {
+export type GetV1UsersByUserIdOrganizationsError = GetV1UsersByUserIdOrganizationsErrors[keyof GetV1UsersByUserIdOrganizationsErrors];
+export type GetV1UsersByUserIdOrganizationsResponses = {
     /**
      * List of organizations
      */
@@ -745,8 +853,8 @@ export type GetV1UsersUserIdOrganizationsResponses = {
         data: Array<Organization>;
     };
 };
-export type GetV1UsersUserIdOrganizationsResponse = GetV1UsersUserIdOrganizationsResponses[keyof GetV1UsersUserIdOrganizationsResponses];
-export type GetV1UsersUserIdCalendarData = {
+export type GetV1UsersByUserIdOrganizationsResponse = GetV1UsersByUserIdOrganizationsResponses[keyof GetV1UsersByUserIdOrganizationsResponses];
+export type GetV1UsersByUserIdCalendarData = {
     body?: never;
     path: {
         userId: string;
@@ -756,13 +864,13 @@ export type GetV1UsersUserIdCalendarData = {
     };
     url: '/v1/users/{userId}/calendar';
 };
-export type GetV1UsersUserIdCalendarErrors = {
+export type GetV1UsersByUserIdCalendarErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -771,6 +879,13 @@ export type GetV1UsersUserIdCalendarErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -778,6 +893,13 @@ export type GetV1UsersUserIdCalendarErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -786,8 +908,8 @@ export type GetV1UsersUserIdCalendarErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdCalendarError = GetV1UsersUserIdCalendarErrors[keyof GetV1UsersUserIdCalendarErrors];
-export type GetV1UsersUserIdCalendarResponses = {
+export type GetV1UsersByUserIdCalendarError = GetV1UsersByUserIdCalendarErrors[keyof GetV1UsersByUserIdCalendarErrors];
+export type GetV1UsersByUserIdCalendarResponses = {
     /**
      * List of calendars
      */
@@ -795,8 +917,8 @@ export type GetV1UsersUserIdCalendarResponses = {
         data: Array<Calendar>;
     };
 };
-export type GetV1UsersUserIdCalendarResponse = GetV1UsersUserIdCalendarResponses[keyof GetV1UsersUserIdCalendarResponses];
-export type GetV1UsersUserIdCalendarBusyData = {
+export type GetV1UsersByUserIdCalendarResponse = GetV1UsersByUserIdCalendarResponses[keyof GetV1UsersByUserIdCalendarResponses];
+export type GetV1UsersByUserIdCalendarBusyData = {
     body?: never;
     path: {
         userId: string;
@@ -815,13 +937,13 @@ export type GetV1UsersUserIdCalendarBusyData = {
     };
     url: '/v1/users/{userId}/calendar/busy';
 };
-export type GetV1UsersUserIdCalendarBusyErrors = {
+export type GetV1UsersByUserIdCalendarBusyErrors = {
     /**
-     * Bad request
+     * Bad request, more calendars requested than the limit allows, or every requested calendar id is invalid
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -831,31 +953,46 @@ export type GetV1UsersUserIdCalendarBusyErrors = {
         error: string;
     };
     /**
-     * User not found
+     * Every requested calendar was denied by the provider, has no mailbox behind it, or the authorization does not cover busy times
+     */
+    403: {
+        data: null;
+        error: string;
+    };
+    /**
+     * User not found, or none of the requested calendars exists
      */
     404: {
         data: null;
         error: string;
     };
     /**
-     * Calendar provider unreachable or returned an unreadable response
+     * The calendar provider throttled every requested calendar
+     */
+    429: {
+        data: null;
+        error: string;
+    };
+    /**
+     * Every requested calendar could not be read
      */
     502: {
         data: null;
         error: string;
     };
 };
-export type GetV1UsersUserIdCalendarBusyError = GetV1UsersUserIdCalendarBusyErrors[keyof GetV1UsersUserIdCalendarBusyErrors];
-export type GetV1UsersUserIdCalendarBusyResponses = {
+export type GetV1UsersByUserIdCalendarBusyError = GetV1UsersByUserIdCalendarBusyErrors[keyof GetV1UsersByUserIdCalendarBusyErrors];
+export type GetV1UsersByUserIdCalendarBusyResponses = {
     /**
-     * List of busy intervals
+     * List of busy intervals, plus the calendars that could not be read
      */
     200: {
         data: Array<TimeRange>;
+        failedCalendars: Array<FailedCalendar>;
     };
 };
-export type GetV1UsersUserIdCalendarBusyResponse = GetV1UsersUserIdCalendarBusyResponses[keyof GetV1UsersUserIdCalendarBusyResponses];
-export type GetV1UsersUserIdCalendarEventsData = {
+export type GetV1UsersByUserIdCalendarBusyResponse = GetV1UsersByUserIdCalendarBusyResponses[keyof GetV1UsersByUserIdCalendarBusyResponses];
+export type GetV1UsersByUserIdCalendarEventsData = {
     body?: never;
     path: {
         userId: string;
@@ -874,13 +1011,13 @@ export type GetV1UsersUserIdCalendarEventsData = {
     };
     url: '/v1/users/{userId}/calendar/events';
 };
-export type GetV1UsersUserIdCalendarEventsErrors = {
+export type GetV1UsersByUserIdCalendarEventsErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -889,6 +1026,13 @@ export type GetV1UsersUserIdCalendarEventsErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -896,6 +1040,13 @@ export type GetV1UsersUserIdCalendarEventsErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -904,8 +1055,8 @@ export type GetV1UsersUserIdCalendarEventsErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdCalendarEventsError = GetV1UsersUserIdCalendarEventsErrors[keyof GetV1UsersUserIdCalendarEventsErrors];
-export type GetV1UsersUserIdCalendarEventsResponses = {
+export type GetV1UsersByUserIdCalendarEventsError = GetV1UsersByUserIdCalendarEventsErrors[keyof GetV1UsersByUserIdCalendarEventsErrors];
+export type GetV1UsersByUserIdCalendarEventsResponses = {
     /**
      * List of events
      */
@@ -913,9 +1064,9 @@ export type GetV1UsersUserIdCalendarEventsResponses = {
         data: Array<Event>;
     };
 };
-export type GetV1UsersUserIdCalendarEventsResponse = GetV1UsersUserIdCalendarEventsResponses[keyof GetV1UsersUserIdCalendarEventsResponses];
-export type PostV1UsersUserIdCalendarEventsMetaData = {
-    body?: CreateMetaEvent;
+export type GetV1UsersByUserIdCalendarEventsResponse = GetV1UsersByUserIdCalendarEventsResponses[keyof GetV1UsersByUserIdCalendarEventsResponses];
+export type PostV1UsersByUserIdCalendarEventsMetaData = {
+    body: CreateMetaEvent;
     path: {
         userId: string;
     };
@@ -924,13 +1075,13 @@ export type PostV1UsersUserIdCalendarEventsMetaData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta';
 };
-export type PostV1UsersUserIdCalendarEventsMetaErrors = {
+export type PostV1UsersByUserIdCalendarEventsMetaErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -939,6 +1090,13 @@ export type PostV1UsersUserIdCalendarEventsMetaErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -946,6 +1104,20 @@ export type PostV1UsersUserIdCalendarEventsMetaErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The provider created the event, but it could not be read back into the Recal event shape
+     */
+    422: {
+        data: null;
+        error: string;
+    };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -954,8 +1126,8 @@ export type PostV1UsersUserIdCalendarEventsMetaErrors = {
         error: string;
     };
 };
-export type PostV1UsersUserIdCalendarEventsMetaError = PostV1UsersUserIdCalendarEventsMetaErrors[keyof PostV1UsersUserIdCalendarEventsMetaErrors];
-export type PostV1UsersUserIdCalendarEventsMetaResponses = {
+export type PostV1UsersByUserIdCalendarEventsMetaError = PostV1UsersByUserIdCalendarEventsMetaErrors[keyof PostV1UsersByUserIdCalendarEventsMetaErrors];
+export type PostV1UsersByUserIdCalendarEventsMetaResponses = {
     /**
      * Meta event created
      */
@@ -963,8 +1135,8 @@ export type PostV1UsersUserIdCalendarEventsMetaResponses = {
         data: MetaEvent;
     };
 };
-export type PostV1UsersUserIdCalendarEventsMetaResponse = PostV1UsersUserIdCalendarEventsMetaResponses[keyof PostV1UsersUserIdCalendarEventsMetaResponses];
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdData = {
+export type PostV1UsersByUserIdCalendarEventsMetaResponse = PostV1UsersByUserIdCalendarEventsMetaResponses[keyof PostV1UsersByUserIdCalendarEventsMetaResponses];
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdData = {
     body?: never;
     path: {
         metaId: string;
@@ -975,13 +1147,13 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -990,6 +1162,13 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * Event not found
      */
@@ -997,6 +1176,13 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1005,8 +1191,8 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         error: string;
     };
 };
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdError = DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdError = DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Meta event deleted
      */
@@ -1016,8 +1202,8 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
         };
     };
 };
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponse = DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponses[keyof DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponses];
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdData = {
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdResponse = DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdResponses[keyof DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdResponses];
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdData = {
     body?: never;
     path: {
         metaId: string;
@@ -1028,13 +1214,13 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1043,6 +1229,13 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * Event not found
      */
@@ -1050,6 +1243,13 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1058,8 +1258,8 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdError = GetV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof GetV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdError = GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Event
      */
@@ -1067,9 +1267,9 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
         data: MetaEvent;
     };
 };
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdResponse = GetV1UsersUserIdCalendarEventsMetaMetaIdResponses[keyof GetV1UsersUserIdCalendarEventsMetaMetaIdResponses];
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdData = {
-    body?: UpdateMetaEvent;
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdResponse = GetV1UsersByUserIdCalendarEventsMetaByMetaIdResponses[keyof GetV1UsersByUserIdCalendarEventsMetaByMetaIdResponses];
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdData = {
+    body: UpdateMetaEvent;
     path: {
         metaId: string;
         userId: string;
@@ -1079,13 +1279,13 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1094,6 +1294,13 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * Event not found
      */
@@ -1101,6 +1308,20 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The provider applied the update, but the event could not be read back into the Recal event shape
+     */
+    422: {
+        data: null;
+        error: string;
+    };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1109,8 +1330,8 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
         error: string;
     };
 };
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdError = PutV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof PutV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdError = PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Meta event updated
      */
@@ -1118,9 +1339,9 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
         data: MetaEvent;
     };
 };
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdResponse = PutV1UsersUserIdCalendarEventsMetaMetaIdResponses[keyof PutV1UsersUserIdCalendarEventsMetaMetaIdResponses];
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdData = {
-    body?: CreateEvent;
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdResponse = PutV1UsersByUserIdCalendarEventsMetaByMetaIdResponses[keyof PutV1UsersByUserIdCalendarEventsMetaByMetaIdResponses];
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdData = {
+    body: CreateEvent;
     path: {
         calendarId: string;
         provider: 'google' | 'microsoft';
@@ -1129,13 +1350,13 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}';
 };
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors = {
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1144,6 +1365,13 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -1151,6 +1379,27 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The `id` supplied for the new event is already taken on that calendar. Google only: the Microsoft path never forwards a caller-supplied id
+     */
+    409: {
+        data: null;
+        error: string;
+    };
+    /**
+     * The provider created the event, but it could not be read back into the Recal event shape
+     */
+    422: {
+        data: null;
+        error: string;
+    };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1159,8 +1408,8 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors = {
         error: string;
     };
 };
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdError = PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors[keyof PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors];
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdResponses = {
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdError = PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors[keyof PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors];
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdResponses = {
     /**
      * Event created
      */
@@ -1168,8 +1417,8 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdResponses = {
         data: Event;
     };
 };
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdResponse = PostV1UsersUserIdCalendarEventsProviderCalendarIdResponses[keyof PostV1UsersUserIdCalendarEventsProviderCalendarIdResponses];
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdResponse = PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdResponses[keyof PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdResponses];
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdData = {
     body?: never;
     path: {
         calendarId: string;
@@ -1180,13 +1429,13 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1195,6 +1444,13 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -1202,6 +1458,13 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1210,8 +1473,8 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         error: string;
     };
 };
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event deleted
      */
@@ -1221,8 +1484,8 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses
         };
     };
 };
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponse = DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses[keyof DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses];
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponse = DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses[keyof DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses];
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdData = {
     body?: never;
     path: {
         calendarId: string;
@@ -1233,13 +1496,13 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1248,6 +1511,13 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -1255,6 +1525,13 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1263,8 +1540,8 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event found
      */
@@ -1272,9 +1549,9 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
         data: Event;
     };
 };
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponse = GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses[keyof GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses];
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
-    body?: UpdateEvent;
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponse = GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses[keyof GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses];
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdData = {
+    body: UpdateEvent;
     path: {
         calendarId: string;
         eventId: string;
@@ -1284,13 +1561,13 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1299,6 +1576,13 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The calendar authorization does not cover the operation. A scope refusal also carries `operation` alongside the envelope, plus `validScopes` when Recal's own pre-flight raised it; a flat denial from the provider carries neither
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found
      */
@@ -1306,6 +1590,20 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         data: null;
         error: string;
     };
+    /**
+     * The provider applied the update, but the event could not be read back into the Recal event shape
+     */
+    422: {
+        data: null;
+        error: string;
+    };
+    /**
+     * The calendar provider throttled the request. When it says how long to wait, the response carries a `Retry-After` header and a `retryAfter` field alongside the envelope
+     */
+    429: {
+        data: null;
+        error: string;
+    };
     /**
      * Calendar provider unreachable or returned an unreadable response
      */
@@ -1314,8 +1612,8 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
         error: string;
     };
 };
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event updated
      */
@@ -1323,8 +1621,8 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
         data: Event;
     };
 };
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponse = PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses[keyof PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses];
-export type GetV1UsersUserIdOauthData = {
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponse = PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses[keyof PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses];
+export type GetV1UsersByUserIdOauthData = {
     body?: never;
     path: {
         userId: string;
@@ -1337,7 +1635,14 @@ export type GetV1UsersUserIdOauthData = {
     };
     url: '/v1/users/{userId}/oauth';
 };
-export type GetV1UsersUserIdOauthErrors = {
+export type GetV1UsersByUserIdOauthErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -1346,8 +1651,8 @@ export type GetV1UsersUserIdOauthErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOauthError = GetV1UsersUserIdOauthErrors[keyof GetV1UsersUserIdOauthErrors];
-export type GetV1UsersUserIdOauthResponses = {
+export type GetV1UsersByUserIdOauthError = GetV1UsersByUserIdOauthErrors[keyof GetV1UsersByUserIdOauthErrors];
+export type GetV1UsersByUserIdOauthResponses = {
     /**
      * All oauth connections of the user
      */
@@ -1355,8 +1660,8 @@ export type GetV1UsersUserIdOauthResponses = {
         data: Array<AuthConnection>;
     };
 };
-export type GetV1UsersUserIdOauthResponse = GetV1UsersUserIdOauthResponses[keyof GetV1UsersUserIdOauthResponses];
-export type GetV1UsersUserIdOauthLinksData = {
+export type GetV1UsersByUserIdOauthResponse = GetV1UsersByUserIdOauthResponses[keyof GetV1UsersByUserIdOauthResponses];
+export type GetV1UsersByUserIdOauthLinksData = {
     body?: never;
     path: {
         userId: string;
@@ -1374,13 +1679,13 @@ export type GetV1UsersUserIdOauthLinksData = {
     };
     url: '/v1/users/{userId}/oauth/links';
 };
-export type GetV1UsersUserIdOauthLinksErrors = {
+export type GetV1UsersByUserIdOauthLinksErrors = {
     /**
      * Invalid request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * User not found
@@ -1390,8 +1695,8 @@ export type GetV1UsersUserIdOauthLinksErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOauthLinksError = GetV1UsersUserIdOauthLinksErrors[keyof GetV1UsersUserIdOauthLinksErrors];
-export type GetV1UsersUserIdOauthLinksResponses = {
+export type GetV1UsersByUserIdOauthLinksError = GetV1UsersByUserIdOauthLinksErrors[keyof GetV1UsersByUserIdOauthLinksErrors];
+export type GetV1UsersByUserIdOauthLinksResponses = {
     /**
      * Auth urls for the oauth providers
      */
@@ -1405,8 +1710,8 @@ export type GetV1UsersUserIdOauthLinksResponses = {
         }>;
     };
 };
-export type GetV1UsersUserIdOauthLinksResponse = GetV1UsersUserIdOauthLinksResponses[keyof GetV1UsersUserIdOauthLinksResponses];
-export type GetV1UsersUserIdOauthProviderLinkData = {
+export type GetV1UsersByUserIdOauthLinksResponse = GetV1UsersByUserIdOauthLinksResponses[keyof GetV1UsersByUserIdOauthLinksResponses];
+export type GetV1UsersByUserIdOauthByProviderLinkData = {
     body?: never;
     path: {
         provider: 'google' | 'microsoft';
@@ -1428,13 +1733,13 @@ export type GetV1UsersUserIdOauthProviderLinkData = {
     };
     url: '/v1/users/{userId}/oauth/{provider}/link';
 };
-export type GetV1UsersUserIdOauthProviderLinkErrors = {
+export type GetV1UsersByUserIdOauthByProviderLinkErrors = {
     /**
      * Invalid request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * User not found
@@ -1444,8 +1749,8 @@ export type GetV1UsersUserIdOauthProviderLinkErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOauthProviderLinkError = GetV1UsersUserIdOauthProviderLinkErrors[keyof GetV1UsersUserIdOauthProviderLinkErrors];
-export type GetV1UsersUserIdOauthProviderLinkResponses = {
+export type GetV1UsersByUserIdOauthByProviderLinkError = GetV1UsersByUserIdOauthByProviderLinkErrors[keyof GetV1UsersByUserIdOauthByProviderLinkErrors];
+export type GetV1UsersByUserIdOauthByProviderLinkResponses = {
     /**
      * Auth url for the oauth provider
      */
@@ -1458,9 +1763,9 @@ export type GetV1UsersUserIdOauthProviderLinkResponses = {
         };
     };
 };
-export type GetV1UsersUserIdOauthProviderLinkResponse = GetV1UsersUserIdOauthProviderLinkResponses[keyof GetV1UsersUserIdOauthProviderLinkResponses];
-export type PostV1UsersOauthProviderVerifyData = {
-    body?: {
+export type GetV1UsersByUserIdOauthByProviderLinkResponse = GetV1UsersByUserIdOauthByProviderLinkResponses[keyof GetV1UsersByUserIdOauthByProviderLinkResponses];
+export type PostV1UsersOauthByProviderVerifyData = {
+    body: {
         code: string;
         scope: Array<string>;
         state: string;
@@ -1476,7 +1781,7 @@ export type PostV1UsersOauthProviderVerifyData = {
     };
     url: '/v1/users/oauth/{provider}/verify';
 };
-export type PostV1UsersOauthProviderVerifyErrors = {
+export type PostV1UsersOauthByProviderVerifyErrors = {
     /**
      * Invalid request
      */
@@ -1492,14 +1797,14 @@ export type PostV1UsersOauthProviderVerifyErrors = {
         error: string;
     };
 };
-export type PostV1UsersOauthProviderVerifyError = PostV1UsersOauthProviderVerifyErrors[keyof PostV1UsersOauthProviderVerifyErrors];
-export type PostV1UsersOauthProviderVerifyResponses = {
+export type PostV1UsersOauthByProviderVerifyError = PostV1UsersOauthByProviderVerifyErrors[keyof PostV1UsersOauthByProviderVerifyErrors];
+export type PostV1UsersOauthByProviderVerifyResponses = {
     /**
      * OAuth code verified successfully
      */
     200: unknown;
 };
-export type DeleteV1UsersUserIdOauthProviderData = {
+export type DeleteV1UsersByUserIdOauthByProviderData = {
     body?: never;
     path: {
         provider: 'google' | 'microsoft';
@@ -1508,7 +1813,14 @@ export type DeleteV1UsersUserIdOauthProviderData = {
     query?: never;
     url: '/v1/users/{userId}/oauth/{provider}';
 };
-export type DeleteV1UsersUserIdOauthProviderErrors = {
+export type DeleteV1UsersByUserIdOauthByProviderErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -1524,14 +1836,14 @@ export type DeleteV1UsersUserIdOauthProviderErrors = {
         error: string;
     };
 };
-export type DeleteV1UsersUserIdOauthProviderError = DeleteV1UsersUserIdOauthProviderErrors[keyof DeleteV1UsersUserIdOauthProviderErrors];
-export type DeleteV1UsersUserIdOauthProviderResponses = {
+export type DeleteV1UsersByUserIdOauthByProviderError = DeleteV1UsersByUserIdOauthByProviderErrors[keyof DeleteV1UsersByUserIdOauthByProviderErrors];
+export type DeleteV1UsersByUserIdOauthByProviderResponses = {
     /**
      * OAuth connection deleted
      */
     200: unknown;
 };
-export type GetV1UsersUserIdOauthProviderData = {
+export type GetV1UsersByUserIdOauthByProviderData = {
     body?: never;
     path: {
         provider: 'google' | 'microsoft';
@@ -1545,7 +1857,14 @@ export type GetV1UsersUserIdOauthProviderData = {
     };
     url: '/v1/users/{userId}/oauth/{provider}';
 };
-export type GetV1UsersUserIdOauthProviderErrors = {
+export type GetV1UsersByUserIdOauthByProviderErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * User not found
      */
@@ -1554,8 +1873,8 @@ export type GetV1UsersUserIdOauthProviderErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOauthProviderError = GetV1UsersUserIdOauthProviderErrors[keyof GetV1UsersUserIdOauthProviderErrors];
-export type GetV1UsersUserIdOauthProviderResponses = {
+export type GetV1UsersByUserIdOauthByProviderError = GetV1UsersByUserIdOauthByProviderErrors[keyof GetV1UsersByUserIdOauthByProviderErrors];
+export type GetV1UsersByUserIdOauthByProviderResponses = {
     /**
      * OAuth connection of the user
      */
@@ -1563,9 +1882,9 @@ export type GetV1UsersUserIdOauthProviderResponses = {
         data: AuthConnection;
     };
 };
-export type GetV1UsersUserIdOauthProviderResponse = GetV1UsersUserIdOauthProviderResponses[keyof GetV1UsersUserIdOauthProviderResponses];
-export type PostV1UsersUserIdOauthProviderData = {
-    body?: {
+export type GetV1UsersByUserIdOauthByProviderResponse = GetV1UsersByUserIdOauthByProviderResponses[keyof GetV1UsersByUserIdOauthByProviderResponses];
+export type PostV1UsersByUserIdOauthByProviderData = {
+    body: {
         accessToken: string;
         email: string | null;
         expiresAt: string | null;
@@ -1579,13 +1898,13 @@ export type PostV1UsersUserIdOauthProviderData = {
     query?: never;
     url: '/v1/users/{userId}/oauth/{provider}';
 };
-export type PostV1UsersUserIdOauthProviderErrors = {
+export type PostV1UsersByUserIdOauthByProviderErrors = {
     /**
      * Invalid request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * User not found
@@ -1595,8 +1914,8 @@ export type PostV1UsersUserIdOauthProviderErrors = {
         error: string;
     };
 };
-export type PostV1UsersUserIdOauthProviderError = PostV1UsersUserIdOauthProviderErrors[keyof PostV1UsersUserIdOauthProviderErrors];
-export type PostV1UsersUserIdOauthProviderResponses = {
+export type PostV1UsersByUserIdOauthByProviderError = PostV1UsersByUserIdOauthByProviderErrors[keyof PostV1UsersByUserIdOauthByProviderErrors];
+export type PostV1UsersByUserIdOauthByProviderResponses = {
     /**
      * OAuth connection created
      */
@@ -1604,8 +1923,8 @@ export type PostV1UsersUserIdOauthProviderResponses = {
         data: AuthConnection;
     };
 };
-export type PostV1UsersUserIdOauthProviderResponse = PostV1UsersUserIdOauthProviderResponses[keyof PostV1UsersUserIdOauthProviderResponses];
-export type GetV1UsersUserIdOauthProviderTokenData = {
+export type PostV1UsersByUserIdOauthByProviderResponse = PostV1UsersByUserIdOauthByProviderResponses[keyof PostV1UsersByUserIdOauthByProviderResponses];
+export type GetV1UsersByUserIdOauthByProviderTokenData = {
     body?: never;
     path: {
         provider: 'google' | 'microsoft';
@@ -1614,13 +1933,13 @@ export type GetV1UsersUserIdOauthProviderTokenData = {
     query?: never;
     url: '/v1/users/{userId}/oauth/{provider}/token';
 };
-export type GetV1UsersUserIdOauthProviderTokenErrors = {
+export type GetV1UsersByUserIdOauthByProviderTokenErrors = {
     /**
      * Invalid request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * User not found
@@ -1630,8 +1949,8 @@ export type GetV1UsersUserIdOauthProviderTokenErrors = {
         error: string;
     };
 };
-export type GetV1UsersUserIdOauthProviderTokenError = GetV1UsersUserIdOauthProviderTokenErrors[keyof GetV1UsersUserIdOauthProviderTokenErrors];
-export type GetV1UsersUserIdOauthProviderTokenResponses = {
+export type GetV1UsersByUserIdOauthByProviderTokenError = GetV1UsersByUserIdOauthByProviderTokenErrors[keyof GetV1UsersByUserIdOauthByProviderTokenErrors];
+export type GetV1UsersByUserIdOauthByProviderTokenResponses = {
     /**
      * Access token
      */
@@ -1641,8 +1960,8 @@ export type GetV1UsersUserIdOauthProviderTokenResponses = {
         };
     };
 };
-export type GetV1UsersUserIdOauthProviderTokenResponse = GetV1UsersUserIdOauthProviderTokenResponses[keyof GetV1UsersUserIdOauthProviderTokenResponses];
-export type GetV1UsersUserIdSchedulingData = {
+export type GetV1UsersByUserIdOauthByProviderTokenResponse = GetV1UsersByUserIdOauthByProviderTokenResponses[keyof GetV1UsersByUserIdOauthByProviderTokenResponses];
+export type GetV1UsersByUserIdSchedulingData = {
     body?: never;
     path: {
         userId: string;
@@ -1680,13 +1999,13 @@ export type GetV1UsersUserIdSchedulingData = {
     };
     url: '/v1/users/{userId}/scheduling';
 };
-export type GetV1UsersUserIdSchedulingErrors = {
+export type GetV1UsersByUserIdSchedulingErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1695,6 +2014,13 @@ export type GetV1UsersUserIdSchedulingErrors = {
         data: null;
         error: string;
     };
+    /**
+     * Every requested calendar was denied by the provider, has no mailbox behind it, or the authorization does not cover busy times
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found, or the user has no connected calendars
      */
@@ -1703,15 +2029,22 @@ export type GetV1UsersUserIdSchedulingErrors = {
         error: string;
     };
     /**
-     * Calendar provider unreachable or returned an unreadable response
+     * The calendar provider throttled every requested calendar
+     */
+    429: {
+        data: null;
+        error: string;
+    };
+    /**
+     * Every requested calendar could not be read
      */
     502: {
         data: null;
         error: string;
     };
 };
-export type GetV1UsersUserIdSchedulingError = GetV1UsersUserIdSchedulingErrors[keyof GetV1UsersUserIdSchedulingErrors];
-export type GetV1UsersUserIdSchedulingResponses = {
+export type GetV1UsersByUserIdSchedulingError = GetV1UsersByUserIdSchedulingErrors[keyof GetV1UsersByUserIdSchedulingErrors];
+export type GetV1UsersByUserIdSchedulingResponses = {
     /**
      * Available time slots
      */
@@ -1748,9 +2081,9 @@ export type GetV1UsersUserIdSchedulingResponses = {
         };
     };
 };
-export type GetV1UsersUserIdSchedulingResponse = GetV1UsersUserIdSchedulingResponses[keyof GetV1UsersUserIdSchedulingResponses];
-export type PostV1UsersUserIdSchedulingData = {
-    body?: {
+export type GetV1UsersByUserIdSchedulingResponse = GetV1UsersByUserIdSchedulingResponses[keyof GetV1UsersByUserIdSchedulingResponses];
+export type PostV1UsersByUserIdSchedulingData = {
+    body: {
         schedules: Array<{
             /**
              * The days to apply this scheduling element to
@@ -1794,13 +2127,13 @@ export type PostV1UsersUserIdSchedulingData = {
     };
     url: '/v1/users/{userId}/scheduling';
 };
-export type PostV1UsersUserIdSchedulingErrors = {
+export type PostV1UsersByUserIdSchedulingErrors = {
     /**
      * Bad request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * Calendar provider rejected the stored access token
@@ -1809,6 +2142,13 @@ export type PostV1UsersUserIdSchedulingErrors = {
         data: null;
         error: string;
     };
+    /**
+     * Every requested calendar was denied by the provider, has no mailbox behind it, or the authorization does not cover busy times
+     */
+    403: {
+        data: null;
+        error: string;
+    };
     /**
      * User not found, or the user has no connected calendars
      */
@@ -1817,15 +2157,22 @@ export type PostV1UsersUserIdSchedulingErrors = {
         error: string;
     };
     /**
-     * Calendar provider unreachable or returned an unreadable response
+     * The calendar provider throttled every requested calendar
+     */
+    429: {
+        data: null;
+        error: string;
+    };
+    /**
+     * Every requested calendar could not be read
      */
     502: {
         data: null;
         error: string;
     };
 };
-export type PostV1UsersUserIdSchedulingError = PostV1UsersUserIdSchedulingErrors[keyof PostV1UsersUserIdSchedulingErrors];
-export type PostV1UsersUserIdSchedulingResponses = {
+export type PostV1UsersByUserIdSchedulingError = PostV1UsersByUserIdSchedulingErrors[keyof PostV1UsersByUserIdSchedulingErrors];
+export type PostV1UsersByUserIdSchedulingResponses = {
     /**
      * Available time slots
      */
@@ -1862,9 +2209,9 @@ export type PostV1UsersUserIdSchedulingResponses = {
         };
     };
 };
-export type PostV1UsersUserIdSchedulingResponse = PostV1UsersUserIdSchedulingResponses[keyof PostV1UsersUserIdSchedulingResponses];
+export type PostV1UsersByUserIdSchedulingResponse = PostV1UsersByUserIdSchedulingResponses[keyof PostV1UsersByUserIdSchedulingResponses];
 export type PostV1UsersSchedulingData = {
-    body?: {
+    body: {
         users: Array<{
             id: string;
             calendarIds?: string | Array<string>;
@@ -1923,13 +2270,24 @@ export type PostV1UsersSchedulingData = {
     };
     url: '/v1/users/scheduling';
 };
+export type PostV1UsersSchedulingErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
+};
+export type PostV1UsersSchedulingError = PostV1UsersSchedulingErrors[keyof PostV1UsersSchedulingErrors];
 export type PostV1UsersSchedulingResponses = {
     /**
-     * Available time slots for each user
+     * Available time slots for each user, plus the calendars that could not be read
      */
     200: {
         data: Array<{
             availableSlots: Array<TimeRange>;
+            failedCalendars: Array<FailedCalendar>;
             options: {
                 /**
                  * End time of the time range in ISO format
@@ -1991,6 +2349,7 @@ export type PostV1UsersSchedulingResponses = {
             error: string;
             status: 'error';
             userId: string;
+            reason?: FreeBusyFailureReason;
         }>;
     };
 };