recal-sdk 1.0.1 → 1.2.0

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

@@ -26,6 +26,7 @@ export type AuthConnection = {
     expiresAt: Date | null;
     provider: 'google' | 'microsoft';
     scope: Array<string>;
+    type: string;
     accessToken?: unknown;
     refreshToken?: unknown;
 };
@@ -42,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
  */
@@ -52,10 +75,11 @@ export type Calendar = {
     accessRole?: 'freeBusyReader' | 'owner' | 'reader' | 'writer';
     backgroundColor?: string;
     foregroundColor?: string;
+    primary?: boolean;
     selected?: boolean;
     subject?: string;
     /**
-     * A valid IANA timezone identifier
+     * a valid IANA timezone identifier
      */
     timeZone?: string;
 };
@@ -199,7 +223,7 @@ export type GetV1OrganizationsResponses = {
 };
 export type GetV1OrganizationsResponse = GetV1OrganizationsResponses[keyof GetV1OrganizationsResponses];
 export type PostV1OrganizationsData = {
-    body?: {
+    body: {
         name: string | null;
         slug: string;
     };
@@ -208,6 +232,13 @@ export type PostV1OrganizationsData = {
     url: '/v1/organizations';
 };
 export type PostV1OrganizationsErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization with slug already exists
      */
@@ -226,7 +257,7 @@ export type PostV1OrganizationsResponses = {
     };
 };
 export type PostV1OrganizationsResponse = PostV1OrganizationsResponses[keyof PostV1OrganizationsResponses];
-export type DeleteV1OrganizationsOrgSlugData = {
+export type DeleteV1OrganizationsByOrgSlugData = {
     body?: never;
     path: {
         orgSlug: string;
@@ -234,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
      */
@@ -243,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
      */
@@ -252,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;
@@ -261,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
      */
@@ -270,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
      */
@@ -279,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;
     };
@@ -291,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
      */
@@ -300,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
      */
@@ -309,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: {
@@ -320,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
      */
@@ -329,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;
@@ -346,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
      */
@@ -355,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
      */
@@ -369,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: {
@@ -380,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
      */
@@ -389,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
      */
@@ -404,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;
@@ -421,7 +494,14 @@ export type GetV1OrganizationsOrgSlugCalendarBusyData = {
     };
     url: '/v1/organizations/{orgSlug}/calendar/busy';
 };
-export type GetV1OrganizationsOrgSlugCalendarBusyErrors = {
+export type GetV1OrganizationsByOrgSlugCalendarBusyErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -430,17 +510,18 @@ export type GetV1OrganizationsOrgSlugCalendarBusyErrors = {
         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;
@@ -450,14 +531,6 @@ export type GetV1OrganizationsOrgSlugSchedulingData = {
          * End time of the time range in ISO format
          */
         end: string;
-        /**
-         * Padding in minutes to add before and after busy times
-         */
-        padding: string | unknown;
-        /**
-         * Duration of each slot in minutes
-         */
-        slotDuration: string | unknown;
         /**
          * Start time of the time range in ISO format
          */
@@ -471,26 +544,41 @@ export type GetV1OrganizationsOrgSlugSchedulingData = {
          */
         latestTimeEachDay?: string;
         /**
-         * An integer >= 0 (default: 0)
+         * an integer >= 0 (default: 0)
+         */
+        maxOverlaps?: string;
+        /**
+         * Padding in minutes to add before and after busy times
          */
-        maxOverlaps?: string | unknown;
+        padding?: string;
         provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
+        /**
+         * Duration of each slot in minutes
+         */
+        slotDuration?: string;
     };
     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: {
@@ -533,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;
@@ -557,7 +646,7 @@ export type GetV1UsersResponses = {
 };
 export type GetV1UsersResponse = GetV1UsersResponses[keyof GetV1UsersResponses];
 export type PostV1UsersData = {
-    body?: {
+    body: {
         id: string;
         organizationSlugs?: Array<string>;
     };
@@ -566,6 +655,13 @@ export type PostV1UsersData = {
     url: '/v1/users';
 };
 export type PostV1UsersErrors = {
+    /**
+     * Validation Error
+     */
+    400: {
+        error: string;
+        data: null;
+    };
     /**
      * Organization not found
      */
@@ -596,7 +692,7 @@ export type PostV1UsersResponses = {
     };
 };
 export type PostV1UsersResponse = PostV1UsersResponses[keyof PostV1UsersResponses];
-export type DeleteV1UsersUserIdData = {
+export type DeleteV1UsersByUserIdData = {
     body?: never;
     path: {
         userId: string;
@@ -604,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
      */
@@ -613,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
      */
@@ -627,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;
@@ -638,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
      */
@@ -647,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
      */
@@ -661,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: {
@@ -672,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
      */
@@ -688,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
      */
@@ -702,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;
@@ -711,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
      */
@@ -720,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
      */
@@ -729,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;
@@ -740,11 +864,25 @@ export type GetV1UsersUserIdCalendarData = {
     };
     url: '/v1/users/{userId}/calendar';
 };
-export type GetV1UsersUserIdCalendarErrors = {
+export type GetV1UsersByUserIdCalendarErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -755,9 +893,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type GetV1UsersUserIdCalendarError = GetV1UsersUserIdCalendarErrors[keyof GetV1UsersUserIdCalendarErrors];
-export type GetV1UsersUserIdCalendarResponses = {
+export type GetV1UsersByUserIdCalendarError = GetV1UsersByUserIdCalendarErrors[keyof GetV1UsersByUserIdCalendarErrors];
+export type GetV1UsersByUserIdCalendarResponses = {
     /**
      * List of calendars
      */
@@ -765,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;
@@ -780,38 +932,67 @@ export type GetV1UsersUserIdCalendarBusyData = {
          * Start time of the time range in ISO format
          */
         start: string;
-        calendarIds?: Array<string>;
+        calendarIds?: string | Array<string>;
         provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
     };
     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: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
         data: null;
         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;
     };
+    /**
+     * 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;
@@ -825,16 +1006,30 @@ export type GetV1UsersUserIdCalendarEventsData = {
          * Start time of the time range in ISO format
          */
         start: string;
-        calendarIds?: Array<string>;
+        calendarIds?: string | Array<string>;
         provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
     };
     url: '/v1/users/{userId}/calendar/events';
 };
-export type GetV1UsersUserIdCalendarEventsErrors = {
+export type GetV1UsersByUserIdCalendarEventsErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -845,9 +1040,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type GetV1UsersUserIdCalendarEventsError = GetV1UsersUserIdCalendarEventsErrors[keyof GetV1UsersUserIdCalendarEventsErrors];
-export type GetV1UsersUserIdCalendarEventsResponses = {
+export type GetV1UsersByUserIdCalendarEventsError = GetV1UsersByUserIdCalendarEventsErrors[keyof GetV1UsersByUserIdCalendarEventsErrors];
+export type GetV1UsersByUserIdCalendarEventsResponses = {
     /**
      * List of events
      */
@@ -855,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;
     };
@@ -866,11 +1075,25 @@ export type PostV1UsersUserIdCalendarEventsMetaData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta';
 };
-export type PostV1UsersUserIdCalendarEventsMetaErrors = {
+export type PostV1UsersByUserIdCalendarEventsMetaErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -881,9 +1104,30 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type PostV1UsersUserIdCalendarEventsMetaError = PostV1UsersUserIdCalendarEventsMetaErrors[keyof PostV1UsersUserIdCalendarEventsMetaErrors];
-export type PostV1UsersUserIdCalendarEventsMetaResponses = {
+export type PostV1UsersByUserIdCalendarEventsMetaError = PostV1UsersByUserIdCalendarEventsMetaErrors[keyof PostV1UsersByUserIdCalendarEventsMetaErrors];
+export type PostV1UsersByUserIdCalendarEventsMetaResponses = {
     /**
      * Meta event created
      */
@@ -891,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;
@@ -903,11 +1147,25 @@ export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -918,9 +1176,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdError = DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof DeleteV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type DeleteV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdError = DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type DeleteV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Meta event deleted
      */
@@ -930,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;
@@ -942,11 +1214,25 @@ export type GetV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -957,9 +1243,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdError = GetV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof GetV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type GetV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdError = GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof GetV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type GetV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Event
      */
@@ -967,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;
@@ -979,11 +1279,25 @@ export type PutV1UsersUserIdCalendarEventsMetaMetaIdData = {
     };
     url: '/v1/users/{userId}/calendar/events/meta/{metaId}';
 };
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdErrors = {
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -994,9 +1308,30 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdError = PutV1UsersUserIdCalendarEventsMetaMetaIdErrors[keyof PutV1UsersUserIdCalendarEventsMetaMetaIdErrors];
-export type PutV1UsersUserIdCalendarEventsMetaMetaIdResponses = {
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdError = PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors[keyof PutV1UsersByUserIdCalendarEventsMetaByMetaIdErrors];
+export type PutV1UsersByUserIdCalendarEventsMetaByMetaIdResponses = {
     /**
      * Meta event updated
      */
@@ -1004,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';
@@ -1015,11 +1350,25 @@ export type PostV1UsersUserIdCalendarEventsProviderCalendarIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}';
 };
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors = {
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -1030,9 +1379,37 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdError = PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors[keyof PostV1UsersUserIdCalendarEventsProviderCalendarIdErrors];
-export type PostV1UsersUserIdCalendarEventsProviderCalendarIdResponses = {
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdError = PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors[keyof PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdErrors];
+export type PostV1UsersByUserIdCalendarEventsByProviderByCalendarIdResponses = {
     /**
      * Event created
      */
@@ -1040,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;
@@ -1052,11 +1429,25 @@ export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -1067,9 +1458,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type DeleteV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type DeleteV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event deleted
      */
@@ -1079,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;
@@ -1091,11 +1496,25 @@ export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -1106,9 +1525,23 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type GetV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type GetV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event found
      */
@@ -1116,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;
@@ -1128,11 +1561,25 @@ export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdData = {
     query?: never;
     url: '/v1/users/{userId}/calendar/events/{provider}/{calendarId}/{eventId}';
 };
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors = {
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
+        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;
     };
@@ -1143,9 +1590,30 @@ 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
+     */
+    502: {
+        data: null;
+        error: string;
+    };
 };
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdError = PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors[keyof PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdErrors];
-export type PutV1UsersUserIdCalendarEventsProviderCalendarIdEventIdResponses = {
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdError = PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors[keyof PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdErrors];
+export type PutV1UsersByUserIdCalendarEventsByProviderByCalendarIdByEventIdResponses = {
     /**
      * Event updated
      */
@@ -1153,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;
@@ -1167,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
      */
@@ -1176,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
      */
@@ -1185,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;
@@ -1199,18 +1674,18 @@ export type GetV1UsersUserIdOauthLinksData = {
         /**
          * Scope of the oauth connection
          */
-        scope: Array<string> | 'edit' | 'free-busy';
+        scope: Array<string> | 'edit' | 'free-busy' | 'read' | 'write';
         provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
     };
     url: '/v1/users/{userId}/oauth/links';
 };
-export type GetV1UsersUserIdOauthLinksErrors = {
+export type GetV1UsersByUserIdOauthLinksErrors = {
     /**
      * Invalid request
      */
     400: {
-        data: null;
         error: string;
+        data: null;
     };
     /**
      * User not found
@@ -1220,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
      */
@@ -1235,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';
@@ -1250,7 +1725,7 @@ export type GetV1UsersUserIdOauthProviderLinkData = {
         /**
          * Scope of the oauth connection
          */
-        scope: Array<string> | 'edit' | 'free-busy';
+        scope: Array<string> | 'edit' | 'free-busy' | 'read' | 'write';
         /**
          * Redirect url for the oauth provider
          */
@@ -1258,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
@@ -1274,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
      */
@@ -1288,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;
@@ -1306,7 +1781,7 @@ export type PostV1UsersOauthProviderVerifyData = {
     };
     url: '/v1/users/oauth/{provider}/verify';
 };
-export type PostV1UsersOauthProviderVerifyErrors = {
+export type PostV1UsersOauthByProviderVerifyErrors = {
     /**
      * Invalid request
      */
@@ -1322,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';
@@ -1338,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
      */
@@ -1346,15 +1828,22 @@ export type DeleteV1UsersUserIdOauthProviderErrors = {
         data: null;
         error: string;
     };
+    /**
+     * Internal server error
+     */
+    500: {
+        data: null;
+        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';
@@ -1368,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
      */
@@ -1377,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
      */
@@ -1386,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;
@@ -1402,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
@@ -1418,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
      */
@@ -1427,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';
@@ -1437,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
@@ -1453,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
      */
@@ -1464,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;
@@ -1475,14 +1971,6 @@ export type GetV1UsersUserIdSchedulingData = {
          * End time of the time range in ISO format
          */
         end: string;
-        /**
-         * Padding in minutes to add before and after busy times
-         */
-        padding: string | unknown;
-        /**
-         * Duration of each slot in minutes
-         */
-        slotDuration: string | unknown;
         /**
          * Start time of the time range in ISO format
          */
@@ -1496,31 +1984,67 @@ export type GetV1UsersUserIdSchedulingData = {
          */
         latestTimeEachDay?: string;
         /**
-         * An integer >= 0 (default: 0)
+         * an integer >= 0 (default: 0)
          */
-        maxOverlaps?: string | unknown;
+        maxOverlaps?: string;
+        /**
+         * Padding in minutes to add before and after busy times
+         */
+        padding?: string;
         provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
+        /**
+         * Duration of each slot in minutes
+         */
+        slotDuration?: string;
     };
     url: '/v1/users/{userId}/scheduling';
 };
-export type GetV1UsersUserIdSchedulingErrors = {
+export type GetV1UsersByUserIdSchedulingErrors = {
     /**
      * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
         data: null;
         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 the user has no connected calendars
      */
     404: {
         data: null;
         error: string;
     };
+    /**
+     * 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
      */
@@ -1557,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
@@ -1584,43 +2108,71 @@ export type PostV1UsersUserIdSchedulingData = {
          */
         end: string;
         /**
-         * Padding in minutes to add before and after busy times
+         * Start time of the time range in ISO format
          */
-        padding: string | unknown;
+        start: string;
         /**
-         * Duration of each slot in minutes
+         * an integer >= 0 (default: 0)
          */
-        slotDuration: string | unknown;
+        maxOverlaps?: string;
         /**
-         * Start time of the time range in ISO format
+         * Padding in minutes to add before and after busy times
          */
-        start: string;
+        padding?: string;
+        provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
         /**
-         * An integer >= 0 (default: 0)
+         * Duration of each slot in minutes
          */
-        maxOverlaps?: string | unknown;
-        provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
+        slotDuration?: string;
     };
     url: '/v1/users/{userId}/scheduling';
 };
-export type PostV1UsersUserIdSchedulingErrors = {
+export type PostV1UsersByUserIdSchedulingErrors = {
     /**
-     * User has no connected calendars
+     * Bad request
      */
     400: {
+        error: string;
+        data: null;
+    };
+    /**
+     * Calendar provider rejected the stored access token
+     */
+    401: {
         data: null;
         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 the user has no connected calendars
      */
     404: {
         data: null;
         error: string;
     };
+    /**
+     * 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
      */
@@ -1657,13 +2209,26 @@ 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?: Array<string>;
-            schedules?: Array<{
+            calendarIds?: string | Array<string>;
+            schedules?: {
+                /**
+                 * The days to apply this scheduling element to
+                 */
+                days: Array<'friday' | 'monday' | 'saturday' | 'sunday' | 'thursday' | 'tuesday' | 'wednesday'>;
+                /**
+                 * End time
+                 */
+                end: string;
+                /**
+                 * Start time
+                 */
+                start: string;
+            } | Array<{
                 /**
                  * The days to apply this scheduling element to
                  */
@@ -1686,32 +2251,43 @@ export type PostV1UsersSchedulingData = {
          */
         end: string;
         /**
-         * Padding in minutes to add before and after busy times
+         * Start time of the time range in ISO format
          */
-        padding: string | unknown;
+        start: string;
         /**
-         * Duration of each slot in minutes
+         * an integer >= 0 (default: 0)
          */
-        slotDuration: string | unknown;
+        maxOverlaps?: string;
         /**
-         * Start time of the time range in ISO format
+         * Padding in minutes to add before and after busy times
          */
-        start: string;
+        padding?: string;
+        provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
         /**
-         * An integer >= 0 (default: 0)
+         * Duration of each slot in minutes
          */
-        maxOverlaps?: string | unknown;
-        provider?: Array<'google' | 'microsoft'> | 'google' | 'microsoft';
+        slotDuration?: string;
     };
     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
@@ -1739,9 +2315,23 @@ export type PostV1UsersSchedulingResponses = {
                  */
                 latestTimeEachDay?: string;
             };
+            status: 'ok';
             userId: string;
-            calendarIds?: Array<string>;
-            schedules?: Array<{
+            calendarIds?: string | Array<string>;
+            schedules?: {
+                /**
+                 * The days to apply this scheduling element to
+                 */
+                days: Array<'friday' | 'monday' | 'saturday' | 'sunday' | 'thursday' | 'tuesday' | 'wednesday'>;
+                /**
+                 * End time
+                 */
+                end: string;
+                /**
+                 * Start time
+                 */
+                start: string;
+            } | Array<{
                 /**
                  * The days to apply this scheduling element to
                  */
@@ -1757,7 +2347,9 @@ export type PostV1UsersSchedulingResponses = {
             }>;
         } | {
             error: string;
+            status: 'error';
             userId: string;
+            reason?: FreeBusyFailureReason;
         }>;
     };
 };