@remit/api-http-client 0.0.52 → 0.0.54

package/types.gen.ts

@@ -5,11 +5,26 @@ export type ClientOptions = {
 };
 
 /**
- * API error response
+ * Every error the API answers with, whatever the status. The body is flat:
+ * `code`, `message` and `details` sit at the top level, with no envelope around
+ * them.
+ *
+ * `code` is always present and is the only field a client branches on. It is a
+ * stable snake_case token — the refusal's own where it has one
+ * (`folder_role_unresolved`, `config_not_empty`), and otherwise the status
+ * class's: `invalid_request`, `unauthorized`, `forbidden`, `not_found`,
+ * `conflict`, `precondition_failed`, `payload_too_large`,
+ * `unprocessable_entity`, `internal_error`, and `request_refused` for a 4xx no
+ * operation declares (405, 408, 415, 429).
+ *
+ * `message` is a sentence for a person and is free to change; nothing may parse
+ * it. `details` carries the strings a client words its own prompt from, and a
+ * 5xx never carries one — an internal failure answers with its status code and
+ * message and nothing else.
  */
 export type ApiError = {
     /**
-     * Error code
+     * Stable token naming the refusal. Branch on this, never on `message`.
      */
     code: string;
     /**
@@ -2316,6 +2331,10 @@ export type RemitImapOrganizePreviewResponse = {
  * A file the server refused, with everything the composer needs to say why
  */
 export type RemitImapOutboxAttachmentRejection = {
+    /**
+     * `attachment_rejected`, the code every refusal here carries. `reason` says which one.
+     */
+    code: string;
     /**
      * Machine-readable reason
      */
@@ -3560,6 +3579,24 @@ export type RemitImapWellknownFlagUpdate = RemitImapAddressFlagBaseUpdate & {
  */
 export type RemitImapZoneCertainty = 'Local' | 'Explicit' | 'Ambiguous';
 
+/**
+ * One reason a request was refused, as the validator read it. Named fields only — nothing here echoes the value that was submitted.
+ */
+export type RequestValidationDetail = {
+    /**
+     * JSON Pointer to the offending value; empty for the document itself
+     */
+    path: string;
+    /**
+     * The rule that refused it, e.g. `required`, `type`, `format`
+     */
+    rule: string;
+    /**
+     * What the validator said
+     */
+    message: string;
+};
+
 export type String140 = string;
 
 export type String2048 = string;
@@ -3574,6 +3611,45 @@ export type String800 = string;
 
 export type Uuid = string;
 
+/**
+ * The request was refused as malformed or contradictory. `code` is
+ * `invalid_request` where nothing more specific is known, and the refusal's own
+ * token where there is one.
+ *
+ * The calendar surface answers with the reason it read the request by:
+ * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+ * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+ * the query, and, for a VCALENDAR it could not accept,
+ * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+ * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+ * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+ * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+ * `unknown_occurrence`.
+ *
+ * `errors` is present only when the request failed schema validation before any
+ * handler ran, and names every field that was refused.
+ */
+export type ValidationError = {
+    /**
+     * Stable token naming the refusal. Branch on this, never on `message`.
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Additional error details
+     */
+    details?: {
+        [key: string]: string;
+    };
+    /**
+     * Every field the schema refused, when the refusal came from schema validation
+     */
+    errors?: Array<RequestValidationDetail>;
+};
+
 /**
  * Account response (excluding sensitive fields). Display name, mute flag, and signatures are sourced from per-account AccountSetting rows (RFC 032), not the Account entity, but are surfaced here so the response shape is unchanged.
  */
@@ -3922,6 +3998,40 @@ export type AccountOperationsCreateAccountData = {
     url: '/accounts';
 };
 
+export type AccountOperationsCreateAccountErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The request contradicts the state the resource is in. `code` is `conflict`
+     * unless the refusal names its own — see `FolderRoleConflict`,
+     * `MessagePlacementConflict` and `ConfigImportConflict`.
+     */
+    409: ApiError;
+};
+
+export type AccountOperationsCreateAccountError = AccountOperationsCreateAccountErrors[keyof AccountOperationsCreateAccountErrors];
+
 export type AccountOperationsCreateAccountResponses = {
     /**
      * The request has succeeded.
@@ -3949,6 +4059,15 @@ export type MicrosoftOAuthOperationsMicrosoftOAuthStartData = {
     url: '/accounts/oauth/microsoft/start';
 };
 
+export type MicrosoftOAuthOperationsMicrosoftOAuthStartErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type MicrosoftOAuthOperationsMicrosoftOAuthStartError = MicrosoftOAuthOperationsMicrosoftOAuthStartErrors[keyof MicrosoftOAuthOperationsMicrosoftOAuthStartErrors];
+
 export type MicrosoftOAuthOperationsMicrosoftOAuthStartResponses = {
     /**
      * The request has succeeded.
@@ -3965,6 +4084,19 @@ export type AccountOperationsTestConnectionData = {
     url: '/accounts/test-connection';
 };
 
+export type AccountOperationsTestConnectionErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type AccountOperationsTestConnectionError = AccountOperationsTestConnectionErrors[keyof AccountOperationsTestConnectionErrors];
+
 export type AccountOperationsTestConnectionResponses = {
     /**
      * The request has succeeded.
@@ -3983,6 +4115,23 @@ export type AccountDetailOperationsDeleteAccountData = {
     url: '/accounts/{accountId}';
 };
 
+export type AccountDetailOperationsDeleteAccountErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type AccountDetailOperationsDeleteAccountError = AccountDetailOperationsDeleteAccountErrors[keyof AccountDetailOperationsDeleteAccountErrors];
+
 export type AccountDetailOperationsDeleteAccountResponses = {
     /**
      * The request has succeeded.
@@ -4001,6 +4150,23 @@ export type AccountDetailOperationsUpdateAccountData = {
     url: '/accounts/{accountId}';
 };
 
+export type AccountDetailOperationsUpdateAccountErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type AccountDetailOperationsUpdateAccountError = AccountDetailOperationsUpdateAccountErrors[keyof AccountDetailOperationsUpdateAccountErrors];
+
 export type AccountDetailOperationsUpdateAccountResponses = {
     /**
      * The request has succeeded.
@@ -4021,6 +4187,38 @@ export type FilterOperationsListFiltersData = {
     url: '/accounts/{accountId}/filters';
 };
 
+export type FilterOperationsListFiltersErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type FilterOperationsListFiltersError = FilterOperationsListFiltersErrors[keyof FilterOperationsListFiltersErrors];
+
 export type FilterOperationsListFiltersResponses = {
     /**
      * The request has succeeded.
@@ -4047,9 +4245,36 @@ export type FilterOperationsCreateFilterData = {
 
 export type FilterOperationsCreateFilterErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
      */
-    400: ApiError;
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
 };
 
 export type FilterOperationsCreateFilterError = FilterOperationsCreateFilterErrors[keyof FilterOperationsCreateFilterErrors];
@@ -4073,9 +4298,26 @@ export type FilterDetailOperationsDeleteFilterData = {
     url: '/accounts/{accountId}/filters/{filterId}';
 };
 
+export type FilterDetailOperationsDeleteFilterErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type FilterDetailOperationsDeleteFilterError = FilterDetailOperationsDeleteFilterErrors[keyof FilterDetailOperationsDeleteFilterErrors];
+
 export type FilterDetailOperationsDeleteFilterResponses = {
     /**
-     * There is no content to send for this request, but the headers may be useful.
+     * Nothing to return. The request succeeded and the response carries no body.
      */
     204: void;
 };
@@ -4092,6 +4334,19 @@ export type FilterDetailOperationsGetFilterData = {
     url: '/accounts/{accountId}/filters/{filterId}';
 };
 
+export type FilterDetailOperationsGetFilterErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type FilterDetailOperationsGetFilterError = FilterDetailOperationsGetFilterErrors[keyof FilterDetailOperationsGetFilterErrors];
+
 export type FilterDetailOperationsGetFilterResponses = {
     /**
      * The request has succeeded.
@@ -4111,6 +4366,23 @@ export type FilterDetailOperationsUpdateFilterData = {
     url: '/accounts/{accountId}/filters/{filterId}';
 };
 
+export type FilterDetailOperationsUpdateFilterErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type FilterDetailOperationsUpdateFilterError = FilterDetailOperationsUpdateFilterErrors[keyof FilterDetailOperationsUpdateFilterErrors];
+
 export type FilterDetailOperationsUpdateFilterResponses = {
     /**
      * The request has succeeded.
@@ -4131,6 +4403,18 @@ export type FolderRoleOperationsAppointFolderRoleData = {
 };
 
 export type FolderRoleOperationsAppointFolderRoleErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
     /**
      * The same flat 409 body as `FolderRoleConflict`, with one code only this endpoint can answer with.
      *
@@ -4163,6 +4447,38 @@ export type LabelOperationsListLabelsData = {
     url: '/accounts/{accountId}/labels';
 };
 
+export type LabelOperationsListLabelsErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type LabelOperationsListLabelsError = LabelOperationsListLabelsErrors[keyof LabelOperationsListLabelsErrors];
+
 export type LabelOperationsListLabelsResponses = {
     /**
      * The request has succeeded.
@@ -4187,6 +4503,23 @@ export type LabelOperationsCreateLabelData = {
     url: '/accounts/{accountId}/labels';
 };
 
+export type LabelOperationsCreateLabelErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type LabelOperationsCreateLabelError = LabelOperationsCreateLabelErrors[keyof LabelOperationsCreateLabelErrors];
+
 export type LabelOperationsCreateLabelResponses = {
     /**
      * The request has succeeded.
@@ -4206,9 +4539,26 @@ export type LabelDetailOperationsDeleteLabelData = {
     url: '/accounts/{accountId}/labels/{labelId}';
 };
 
+export type LabelDetailOperationsDeleteLabelErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type LabelDetailOperationsDeleteLabelError = LabelDetailOperationsDeleteLabelErrors[keyof LabelDetailOperationsDeleteLabelErrors];
+
 export type LabelDetailOperationsDeleteLabelResponses = {
     /**
-     * There is no content to send for this request, but the headers may be useful.
+     * Nothing to return. The request succeeded and the response carries no body.
      */
     204: void;
 };
@@ -4225,6 +4575,19 @@ export type LabelDetailOperationsGetLabelData = {
     url: '/accounts/{accountId}/labels/{labelId}';
 };
 
+export type LabelDetailOperationsGetLabelErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type LabelDetailOperationsGetLabelError = LabelDetailOperationsGetLabelErrors[keyof LabelDetailOperationsGetLabelErrors];
+
 export type LabelDetailOperationsGetLabelResponses = {
     /**
      * The request has succeeded.
@@ -4244,6 +4607,23 @@ export type LabelDetailOperationsUpdateLabelData = {
     url: '/accounts/{accountId}/labels/{labelId}';
 };
 
+export type LabelDetailOperationsUpdateLabelErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type LabelDetailOperationsUpdateLabelError = LabelDetailOperationsUpdateLabelErrors[keyof LabelDetailOperationsUpdateLabelErrors];
+
 export type LabelDetailOperationsUpdateLabelResponses = {
     /**
      * The request has succeeded.
@@ -4264,6 +4644,38 @@ export type MailboxOperationsListMailboxesData = {
     url: '/accounts/{accountId}/mailboxes';
 };
 
+export type MailboxOperationsListMailboxesErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MailboxOperationsListMailboxesError = MailboxOperationsListMailboxesErrors[keyof MailboxOperationsListMailboxesErrors];
+
 export type MailboxOperationsListMailboxesResponses = {
     /**
      * The request has succeeded.
@@ -4288,6 +4700,23 @@ export type MailboxOperationsCreateMailboxData = {
     url: '/accounts/{accountId}/mailboxes';
 };
 
+export type MailboxOperationsCreateMailboxErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MailboxOperationsCreateMailboxError = MailboxOperationsCreateMailboxErrors[keyof MailboxOperationsCreateMailboxErrors];
+
 export type MailboxOperationsCreateMailboxResponses = {
     /**
      * The request has succeeded.
@@ -4307,9 +4736,26 @@ export type MailboxDetailOperationsDeleteMailboxData = {
     url: '/accounts/{accountId}/mailboxes/{mailboxId}';
 };
 
+export type MailboxDetailOperationsDeleteMailboxErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MailboxDetailOperationsDeleteMailboxError = MailboxDetailOperationsDeleteMailboxErrors[keyof MailboxDetailOperationsDeleteMailboxErrors];
+
 export type MailboxDetailOperationsDeleteMailboxResponses = {
     /**
-     * There is no content to send for this request, but the headers may be useful.
+     * Nothing to return. The request succeeded and the response carries no body.
      */
     204: void;
 };
@@ -4326,6 +4772,19 @@ export type MailboxDetailOperationsGetMailboxData = {
     url: '/accounts/{accountId}/mailboxes/{mailboxId}';
 };
 
+export type MailboxDetailOperationsGetMailboxErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MailboxDetailOperationsGetMailboxError = MailboxDetailOperationsGetMailboxErrors[keyof MailboxDetailOperationsGetMailboxErrors];
+
 export type MailboxDetailOperationsGetMailboxResponses = {
     /**
      * The request has succeeded.
@@ -4345,6 +4804,23 @@ export type MailboxDetailOperationsRenameMailboxData = {
     url: '/accounts/{accountId}/mailboxes/{mailboxId}';
 };
 
+export type MailboxDetailOperationsRenameMailboxErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MailboxDetailOperationsRenameMailboxError = MailboxDetailOperationsRenameMailboxErrors[keyof MailboxDetailOperationsRenameMailboxErrors];
+
 export type MailboxDetailOperationsRenameMailboxResponses = {
     /**
      * The request has succeeded.
@@ -4365,9 +4841,36 @@ export type OrganizeOperationsCreateOrganizeJobData = {
 
 export type OrganizeOperationsCreateOrganizeJobErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
      */
-    400: ApiError;
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
 };
 
 export type OrganizeOperationsCreateOrganizeJobError = OrganizeOperationsCreateOrganizeJobErrors[keyof OrganizeOperationsCreateOrganizeJobErrors];
@@ -4392,9 +4895,32 @@ export type OrganizeOperationsPreviewOrganizeData = {
 
 export type OrganizeOperationsPreviewOrganizeErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
-    400: ApiError;
+    404: ApiError;
 };
 
 export type OrganizeOperationsPreviewOrganizeError = OrganizeOperationsPreviewOrganizeErrors[keyof OrganizeOperationsPreviewOrganizeErrors];
@@ -4418,9 +4944,22 @@ export type OrganizeJobDetailOperationsGetOrganizeJobData = {
     url: '/accounts/{accountId}/organize/{organizeJobId}';
 };
 
-export type OrganizeJobDetailOperationsGetOrganizeJobResponses = {
+export type OrganizeJobDetailOperationsGetOrganizeJobErrors = {
     /**
-     * The request has succeeded.
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OrganizeJobDetailOperationsGetOrganizeJobError = OrganizeJobDetailOperationsGetOrganizeJobErrors[keyof OrganizeJobDetailOperationsGetOrganizeJobErrors];
+
+export type OrganizeJobDetailOperationsGetOrganizeJobResponses = {
+    /**
+     * The request has succeeded.
      */
     200: RemitImapOrganizeJobResponse;
 };
@@ -4436,6 +4975,23 @@ export type SyncOperationsTriggerSyncData = {
     url: '/accounts/{accountId}/sync';
 };
 
+export type SyncOperationsTriggerSyncErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type SyncOperationsTriggerSyncError = SyncOperationsTriggerSyncErrors[keyof SyncOperationsTriggerSyncErrors];
+
 export type SyncOperationsTriggerSyncResponses = {
     /**
      * The request has succeeded.
@@ -4454,6 +5010,19 @@ export type SyncOperationsGetSyncStatusData = {
     url: '/accounts/{accountId}/sync/status';
 };
 
+export type SyncOperationsGetSyncStatusErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type SyncOperationsGetSyncStatusError = SyncOperationsGetSyncStatusErrors[keyof SyncOperationsGetSyncStatusErrors];
+
 export type SyncOperationsGetSyncStatusResponses = {
     /**
      * The request has succeeded.
@@ -4473,6 +5042,18 @@ export type TrashOperationsEmptyTrashData = {
 };
 
 export type TrashOperationsEmptyTrashErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
     /**
      * An action was refused because the folder role it needs is not settled. The body is flat: `code`, `message` and `details` sit at the top level, which is what the API emits. Clients branch on `code` and word their prompt from `details`, never from `message`.
      *
@@ -4502,6 +5083,15 @@ export type AddressOperationsSearchAddressesData = {
     url: '/addresses/search';
 };
 
+export type AddressOperationsSearchAddressesErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type AddressOperationsSearchAddressesError = AddressOperationsSearchAddressesErrors[keyof AddressOperationsSearchAddressesErrors];
+
 export type AddressOperationsSearchAddressesResponses = {
     /**
      * The request has succeeded.
@@ -4526,6 +5116,23 @@ export type AddressDetailOperationsUpdateAddressData = {
     url: '/addresses/{addressId}';
 };
 
+export type AddressDetailOperationsUpdateAddressErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type AddressDetailOperationsUpdateAddressError = AddressDetailOperationsUpdateAddressErrors[keyof AddressDetailOperationsUpdateAddressErrors];
+
 export type AddressDetailOperationsUpdateAddressResponses = {
     /**
      * The request has succeeded.
@@ -4557,11 +5164,30 @@ export type CalendarEventOperationsListCalendarEventsData = {
 
 export type CalendarEventOperationsListCalendarEventsErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -4586,11 +5212,30 @@ export type CalendarEventOperationsCreateCalendarEventData = {
 
 export type CalendarEventOperationsCreateCalendarEventErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -4633,11 +5278,30 @@ export type CalendarEventDetailOperationsDeleteCalendarEventData = {
 
 export type CalendarEventDetailOperationsDeleteCalendarEventErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
     /**
@@ -4645,7 +5309,7 @@ export type CalendarEventDetailOperationsDeleteCalendarEventErrors = {
      * `If-Match` names an etag the stored resource no longer carries: somebody else
      * wrote it in between, so applying this request would silently discard their
      * change. The client re-reads the resource and decides what to do with the
-     * version it now has.
+     * version it now has. `code` is `precondition_failed`.
      */
     412: ApiError;
 };
@@ -4677,11 +5341,30 @@ export type CalendarEventDetailOperationsGetCalendarEventData = {
 
 export type CalendarEventDetailOperationsGetCalendarEventErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -4724,11 +5407,30 @@ export type CalendarEventDetailOperationsUpdateCalendarEventData = {
 
 export type CalendarEventDetailOperationsUpdateCalendarEventErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
     /**
@@ -4736,7 +5438,7 @@ export type CalendarEventDetailOperationsUpdateCalendarEventErrors = {
      * `If-Match` names an etag the stored resource no longer carries: somebody else
      * wrote it in between, so applying this request would silently discard their
      * change. The client re-reads the resource and decides what to do with the
-     * version it now has.
+     * version it now has. `code` is `precondition_failed`.
      */
     412: ApiError;
 };
@@ -4770,9 +5472,28 @@ export type CalendarFreeBusyOperationsListCalendarFreeBusyData = {
 
 export type CalendarFreeBusyOperationsListCalendarFreeBusyErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
 };
 
 export type CalendarFreeBusyOperationsListCalendarFreeBusyError = CalendarFreeBusyOperationsListCalendarFreeBusyErrors[keyof CalendarFreeBusyOperationsListCalendarFreeBusyErrors];
@@ -4798,9 +5519,28 @@ export type CalendarSuggestionOperationsListCalendarSuggestionsData = {
 
 export type CalendarSuggestionOperationsListCalendarSuggestionsErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
 };
 
 export type CalendarSuggestionOperationsListCalendarSuggestionsError = CalendarSuggestionOperationsListCalendarSuggestionsErrors[keyof CalendarSuggestionOperationsListCalendarSuggestionsErrors];
@@ -4831,9 +5571,32 @@ export type CalendarSuggestionActionOperationsAcceptCalendarSuggestionData = {
 
 export type CalendarSuggestionActionOperationsAcceptCalendarSuggestionErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
-    400: ApiError;
+    404: ApiError;
 };
 
 export type CalendarSuggestionActionOperationsAcceptCalendarSuggestionError = CalendarSuggestionActionOperationsAcceptCalendarSuggestionErrors[keyof CalendarSuggestionActionOperationsAcceptCalendarSuggestionErrors];
@@ -4858,9 +5621,32 @@ export type CalendarSuggestionActionOperationsDeclineCalendarSuggestionData = {
 
 export type CalendarSuggestionActionOperationsDeclineCalendarSuggestionErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
-    400: ApiError;
+    404: ApiError;
 };
 
 export type CalendarSuggestionActionOperationsDeclineCalendarSuggestionError = CalendarSuggestionActionOperationsDeclineCalendarSuggestionErrors[keyof CalendarSuggestionActionOperationsDeclineCalendarSuggestionErrors];
@@ -4885,9 +5671,32 @@ export type CalendarSuggestionActionOperationsDismissCalendarSuggestionData = {
 
 export type CalendarSuggestionActionOperationsDismissCalendarSuggestionErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
 };
 
 export type CalendarSuggestionActionOperationsDismissCalendarSuggestionError = CalendarSuggestionActionOperationsDismissCalendarSuggestionErrors[keyof CalendarSuggestionActionOperationsDismissCalendarSuggestionErrors];
@@ -4908,6 +5717,15 @@ export type CalendarOperationsListCalendarsData = {
     url: '/calendars';
 };
 
+export type CalendarOperationsListCalendarsErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type CalendarOperationsListCalendarsError = CalendarOperationsListCalendarsErrors[keyof CalendarOperationsListCalendarsErrors];
+
 export type CalendarOperationsListCalendarsResponses = {
     /**
      * The request has succeeded.
@@ -4926,9 +5744,28 @@ export type CalendarOperationsCreateCalendarData = {
 
 export type CalendarOperationsCreateCalendarErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
 };
 
 export type CalendarOperationsCreateCalendarError = CalendarOperationsCreateCalendarErrors[keyof CalendarOperationsCreateCalendarErrors];
@@ -4953,11 +5790,30 @@ export type CalendarDetailOperationsDeleteCalendarData = {
 
 export type CalendarDetailOperationsDeleteCalendarErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -4984,7 +5840,11 @@ export type CalendarDetailOperationsGetCalendarData = {
 
 export type CalendarDetailOperationsGetCalendarErrors = {
     /**
-     * Not found error response
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -5011,11 +5871,30 @@ export type CalendarDetailOperationsUpdateCalendarData = {
 
 export type CalendarDetailOperationsUpdateCalendarErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
-     * Not found error response
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -5042,7 +5921,11 @@ export type CalendarDetailOperationsRevokeCalendarFeedData = {
 
 export type CalendarDetailOperationsRevokeCalendarFeedErrors = {
     /**
-     * Not found error response
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -5069,7 +5952,11 @@ export type CalendarDetailOperationsGetCalendarFeedData = {
 
 export type CalendarDetailOperationsGetCalendarFeedErrors = {
     /**
-     * Not found error response
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -5096,7 +5983,11 @@ export type CalendarDetailOperationsPutCalendarFeedData = {
 
 export type CalendarDetailOperationsPutCalendarFeedErrors = {
     /**
-     * Not found error response
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
      */
     404: ApiError;
 };
@@ -5119,6 +6010,15 @@ export type ConfigOperationsGetConfigData = {
     url: '/config';
 };
 
+export type ConfigOperationsGetConfigErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type ConfigOperationsGetConfigError = ConfigOperationsGetConfigErrors[keyof ConfigOperationsGetConfigErrors];
+
 export type ConfigOperationsGetConfigResponses = {
     /**
      * The request has succeeded.
@@ -5135,6 +6035,15 @@ export type ConfigOperationsExportConfigData = {
     url: '/config/export';
 };
 
+export type ConfigOperationsExportConfigErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type ConfigOperationsExportConfigError = ConfigOperationsExportConfigErrors[keyof ConfigOperationsExportConfigErrors];
+
 export type ConfigOperationsExportConfigResponses = {
     /**
      * The request has succeeded.
@@ -5153,9 +6062,28 @@ export type ConfigOperationsImportConfigData = {
 
 export type ConfigOperationsImportConfigErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
     /**
      * The import was refused because this configuration is not empty. The body is
      * flat: `code`, `message` and `details` sit at the top level.
@@ -5237,6 +6165,34 @@ export type ThreadOperationsListThreadsData = {
     url: '/mailboxes/{mailboxId}/threads';
 };
 
+export type ThreadOperationsListThreadsErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type ThreadOperationsListThreadsError = ThreadOperationsListThreadsErrors[keyof ThreadOperationsListThreadsErrors];
+
 export type ThreadOperationsListThreadsResponses = {
     /**
      * The request has succeeded.
@@ -5303,6 +6259,34 @@ export type ThreadOperationsSearchThreadsData = {
     url: '/mailboxes/{mailboxId}/threads/search';
 };
 
+export type ThreadOperationsSearchThreadsErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type ThreadOperationsSearchThreadsError = ThreadOperationsSearchThreadsErrors[keyof ThreadOperationsSearchThreadsErrors];
+
 export type ThreadOperationsSearchThreadsResponses = {
     /**
      * The request has succeeded.
@@ -5321,9 +6305,28 @@ export type MeOperationsDeleteMeData = {
 
 export type MeOperationsDeleteMeErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
 };
 
 export type MeOperationsDeleteMeError = MeOperationsDeleteMeErrors[keyof MeOperationsDeleteMeErrors];
@@ -5344,6 +6347,15 @@ export type MeOperationsCreateExportData = {
     url: '/me/export';
 };
 
+export type MeOperationsCreateExportErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type MeOperationsCreateExportError = MeOperationsCreateExportErrors[keyof MeOperationsCreateExportErrors];
+
 export type MeOperationsCreateExportResponses = {
     /**
      * Response body for POST /me/export
@@ -5362,6 +6374,19 @@ export type MeOperationsGetExportData = {
     url: '/me/export/{exportId}';
 };
 
+export type MeOperationsGetExportErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MeOperationsGetExportError = MeOperationsGetExportErrors[keyof MeOperationsGetExportErrors];
+
 export type MeOperationsGetExportResponses = {
     /**
      * The request has succeeded.
@@ -5378,6 +6403,15 @@ export type MeOperationsListQuarantineData = {
     url: '/me/quarantine';
 };
 
+export type MeOperationsListQuarantineErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type MeOperationsListQuarantineError = MeOperationsListQuarantineErrors[keyof MeOperationsListQuarantineErrors];
+
 export type MeOperationsListQuarantineResponses = {
     /**
      * The request has succeeded.
@@ -5394,6 +6428,15 @@ export type MeOperationsListVipSuggestionsData = {
     url: '/me/vip-suggestions';
 };
 
+export type MeOperationsListVipSuggestionsErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type MeOperationsListVipSuggestionsError = MeOperationsListVipSuggestionsErrors[keyof MeOperationsListVipSuggestionsErrors];
+
 export type MeOperationsListVipSuggestionsResponses = {
     /**
      * The request has succeeded.
@@ -5411,6 +6454,18 @@ export type MessageBulkOperationsCopyMessagesData = {
 };
 
 export type MessageBulkOperationsCopyMessagesErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
     /**
      * The same flat 409 body, for a message whose folder and uid do not name the same message.
      *
@@ -5438,6 +6493,18 @@ export type MessageBulkOperationsDeleteMessagesData = {
 };
 
 export type MessageBulkOperationsDeleteMessagesErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
     /**
      * The same flat 409 body, with the two codes this endpoint can answer with.
      *
@@ -5466,6 +6533,23 @@ export type MessageBulkOperationsUpdateFlagsData = {
     url: '/messages/flags';
 };
 
+export type MessageBulkOperationsUpdateFlagsErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageBulkOperationsUpdateFlagsError = MessageBulkOperationsUpdateFlagsErrors[keyof MessageBulkOperationsUpdateFlagsErrors];
+
 export type MessageBulkOperationsUpdateFlagsResponses = {
     /**
      * The request has succeeded.
@@ -5482,6 +6566,23 @@ export type MessageBulkOperationsUpdateMessageLabelsData = {
     url: '/messages/labels';
 };
 
+export type MessageBulkOperationsUpdateMessageLabelsErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageBulkOperationsUpdateMessageLabelsError = MessageBulkOperationsUpdateMessageLabelsErrors[keyof MessageBulkOperationsUpdateMessageLabelsErrors];
+
 export type MessageBulkOperationsUpdateMessageLabelsResponses = {
     /**
      * The request has succeeded.
@@ -5499,6 +6600,18 @@ export type MessageBulkOperationsMoveMessagesData = {
 };
 
 export type MessageBulkOperationsMoveMessagesErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
     /**
      * The same flat 409 body, for a message whose folder and uid do not name the same message.
      *
@@ -5525,6 +6638,23 @@ export type MessageBulkOperationsNotSpamData = {
     url: '/messages/not-spam';
 };
 
+export type MessageBulkOperationsNotSpamErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageBulkOperationsNotSpamError = MessageBulkOperationsNotSpamErrors[keyof MessageBulkOperationsNotSpamErrors];
+
 export type MessageBulkOperationsNotSpamResponses = {
     /**
      * The request has succeeded.
@@ -5541,6 +6671,23 @@ export type MessageBulkOperationsReportSpamData = {
     url: '/messages/report-spam';
 };
 
+export type MessageBulkOperationsReportSpamErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageBulkOperationsReportSpamError = MessageBulkOperationsReportSpamErrors[keyof MessageBulkOperationsReportSpamErrors];
+
 export type MessageBulkOperationsReportSpamResponses = {
     /**
      * The request has succeeded.
@@ -5559,6 +6706,23 @@ export type MessageOperationsDescribeMessageData = {
     url: '/messages/{messageId}';
 };
 
+export type MessageOperationsDescribeMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+    /**
+     * The request is well-formed but the thing it names cannot be produced. `code` is `unprocessable_entity`.
+     */
+    422: ApiError;
+};
+
+export type MessageOperationsDescribeMessageError = MessageOperationsDescribeMessageErrors[keyof MessageOperationsDescribeMessageErrors];
+
 export type MessageOperationsDescribeMessageResponses = {
     /**
      * The request has succeeded.
@@ -5579,9 +6743,28 @@ export type MessageCalendarSuggestionOperationsListMessageCalendarSuggestionsDat
 
 export type MessageCalendarSuggestionOperationsListMessageCalendarSuggestionsErrors = {
     /**
-     * Validation error response
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
      */
-    400: ApiError;
+    401: ApiError;
 };
 
 export type MessageCalendarSuggestionOperationsListMessageCalendarSuggestionsError = MessageCalendarSuggestionOperationsListMessageCalendarSuggestionsErrors[keyof MessageCalendarSuggestionOperationsListMessageCalendarSuggestionsErrors];
@@ -5610,6 +6793,23 @@ export type MessageOperationsUpdateMessageFlagsData = {
     url: '/messages/{messageId}/flags';
 };
 
+export type MessageOperationsUpdateMessageFlagsErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageOperationsUpdateMessageFlagsError = MessageOperationsUpdateMessageFlagsErrors[keyof MessageOperationsUpdateMessageFlagsErrors];
+
 export type MessageOperationsUpdateMessageFlagsResponses = {
     /**
      * The request has succeeded.
@@ -5632,6 +6832,19 @@ export type MessageOperationsGetRawMessageData = {
     url: '/messages/{messageId}/raw';
 };
 
+export type MessageOperationsGetRawMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type MessageOperationsGetRawMessageError = MessageOperationsGetRawMessageErrors[keyof MessageOperationsGetRawMessageErrors];
+
 export type MessageOperationsGetRawMessageResponses = {
     /**
      * The request has succeeded.
@@ -5650,6 +6863,34 @@ export type OutboxOperationsListOutboxMessagesData = {
     url: '/outbox';
 };
 
+export type OutboxOperationsListOutboxMessagesErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type OutboxOperationsListOutboxMessagesError = OutboxOperationsListOutboxMessagesErrors[keyof OutboxOperationsListOutboxMessagesErrors];
+
 export type OutboxOperationsListOutboxMessagesResponses = {
     /**
      * The request has succeeded.
@@ -5672,6 +6913,23 @@ export type OutboxOperationsCreateOutboxMessageData = {
     url: '/outbox';
 };
 
+export type OutboxOperationsCreateOutboxMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OutboxOperationsCreateOutboxMessageError = OutboxOperationsCreateOutboxMessageErrors[keyof OutboxOperationsCreateOutboxMessageErrors];
+
 export type OutboxOperationsCreateOutboxMessageResponses = {
     /**
      * The request has succeeded.
@@ -5690,9 +6948,26 @@ export type OutboxDetailOperationsDeleteOutboxMessageData = {
     url: '/outbox/{outboxMessageId}';
 };
 
+export type OutboxDetailOperationsDeleteOutboxMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OutboxDetailOperationsDeleteOutboxMessageError = OutboxDetailOperationsDeleteOutboxMessageErrors[keyof OutboxDetailOperationsDeleteOutboxMessageErrors];
+
 export type OutboxDetailOperationsDeleteOutboxMessageResponses = {
     /**
-     * There is no content to send for this request, but the headers may be useful.
+     * Nothing to return. The request succeeded and the response carries no body.
      */
     204: void;
 };
@@ -5708,6 +6983,19 @@ export type OutboxDetailOperationsGetOutboxMessageData = {
     url: '/outbox/{outboxMessageId}';
 };
 
+export type OutboxDetailOperationsGetOutboxMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OutboxDetailOperationsGetOutboxMessageError = OutboxDetailOperationsGetOutboxMessageErrors[keyof OutboxDetailOperationsGetOutboxMessageErrors];
+
 export type OutboxDetailOperationsGetOutboxMessageResponses = {
     /**
      * The request has succeeded.
@@ -5726,6 +7014,23 @@ export type OutboxDetailOperationsUpdateOutboxMessageData = {
     url: '/outbox/{outboxMessageId}';
 };
 
+export type OutboxDetailOperationsUpdateOutboxMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OutboxDetailOperationsUpdateOutboxMessageError = OutboxDetailOperationsUpdateOutboxMessageErrors[keyof OutboxDetailOperationsUpdateOutboxMessageErrors];
+
 export type OutboxDetailOperationsUpdateOutboxMessageResponses = {
     /**
      * The request has succeeded.
@@ -5746,11 +7051,15 @@ export type OutboxDetailOperationsMintOutboxAttachmentData = {
 
 export type OutboxDetailOperationsMintOutboxAttachmentErrors = {
     /**
-     * Refusal response for an attachment
+     * Refusal response for an attachment. Flat, like every other error body.
      */
     400: RemitImapOutboxAttachmentRejection;
     /**
-     * Refusal response for an attachment
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Refusal response for an attachment. Flat, like every other error body.
      */
     413: RemitImapOutboxAttachmentRejection;
 };
@@ -5778,11 +7087,15 @@ export type OutboxAttachmentOperationsCompleteOutboxAttachmentData = {
 
 export type OutboxAttachmentOperationsCompleteOutboxAttachmentErrors = {
     /**
-     * Refusal response for an attachment
+     * Refusal response for an attachment. Flat, like every other error body.
      */
     400: RemitImapOutboxAttachmentRejection;
     /**
-     * Refusal response for an attachment
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Refusal response for an attachment. Flat, like every other error body.
      */
     413: RemitImapOutboxAttachmentRejection;
 };
@@ -5807,6 +7120,23 @@ export type OutboxDetailOperationsSendOutboxMessageData = {
     url: '/outbox/{outboxMessageId}/send';
 };
 
+export type OutboxDetailOperationsSendOutboxMessageErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * The caller is known and may not do this. `code` is `forbidden`.
+     */
+    403: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type OutboxDetailOperationsSendOutboxMessageError = OutboxDetailOperationsSendOutboxMessageErrors[keyof OutboxDetailOperationsSendOutboxMessageErrors];
+
 export type OutboxDetailOperationsSendOutboxMessageResponses = {
     /**
      * The request has succeeded.
@@ -5860,6 +7190,15 @@ export type SemanticSearchOperationsSemanticSearchData = {
     url: '/search/semantic';
 };
 
+export type SemanticSearchOperationsSemanticSearchErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type SemanticSearchOperationsSemanticSearchError = SemanticSearchOperationsSemanticSearchErrors[keyof SemanticSearchOperationsSemanticSearchErrors];
+
 export type SemanticSearchOperationsSemanticSearchResponses = {
     /**
      * The request has succeeded.
@@ -5880,6 +7219,19 @@ export type SystemOperationsGetSystemUpdateData = {
     url: '/system/update';
 };
 
+export type SystemOperationsGetSystemUpdateErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type SystemOperationsGetSystemUpdateError = SystemOperationsGetSystemUpdateErrors[keyof SystemOperationsGetSystemUpdateErrors];
+
 export type SystemOperationsGetSystemUpdateResponses = {
     /**
      * The request has succeeded.
@@ -5896,6 +7248,29 @@ export type SystemOperationsApplySystemUpdateData = {
     url: '/system/update';
 };
 
+export type SystemOperationsApplySystemUpdateErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+    /**
+     * The request contradicts the state the resource is in. `code` is `conflict`
+     * unless the refusal names its own — see `FolderRoleConflict`,
+     * `MessagePlacementConflict` and `ConfigImportConflict`.
+     */
+    409: ApiError;
+    /**
+     * The request is well-formed but the thing it names cannot be produced. `code` is `unprocessable_entity`.
+     */
+    422: ApiError;
+};
+
+export type SystemOperationsApplySystemUpdateError = SystemOperationsApplySystemUpdateErrors[keyof SystemOperationsApplySystemUpdateErrors];
+
 export type SystemOperationsApplySystemUpdateResponses = {
     /**
      * The request has succeeded.
@@ -5932,6 +7307,10 @@ export type UnifiedThreadOperationsListAllThreadsData = {
          * Narrow every mode to one account's mailboxes. The listing, the search and the `count` all read the same narrowed scope, so a count is the size of what the caller renders rather than of the cross-account aggregate. An account the caller does not own, or one that is muted, holds no mailboxes here and matches nothing.
          */
         accountId?: Uuid;
+        /**
+         * Narrow every mode to one folder. Applied to the same scope `accountId` narrows, and after it, so the two compose and a folder of another account matches nothing. A folder outside the scope — Trash, a muted folder, one of a muted account — matches nothing either. The listing, the search and the `count` all read the narrowed scope, which is what lets a caller ask how much of a cross-account search one folder holds and get the conversations that folder would render, not a page's share of them.
+         */
+        mailboxId?: Uuid;
         /**
          * Filter by whether the From address is muted. `false` excludes muted senders, `true` returns only them, and omitting it filters nothing. Muting lives on the Address rather than on the row, so this is evaluated against the sender's flags; it narrows the `count` exactly as it narrows the listing.
          */
@@ -5960,6 +7339,34 @@ export type UnifiedThreadOperationsListAllThreadsData = {
     url: '/threads';
 };
 
+export type UnifiedThreadOperationsListAllThreadsErrors = {
+    /**
+     * The request was refused as malformed or contradictory. `code` is
+     * `invalid_request` where nothing more specific is known, and the refusal's own
+     * token where there is one.
+     *
+     * The calendar surface answers with the reason it read the request by:
+     * `invalid_window`, `invalid_scope`, `invalid_url_segment`, `url_segment_taken`,
+     * `unknown_time_zone` and `default_calendar_undeletable` on the collection and
+     * the query, and, for a VCALENDAR it could not accept,
+     * `malformed_icalendar`, `not_a_calendar`, `unsupported_component`, `no_event`,
+     * `no_master_event`, `multiple_master_events`, `missing_uid`, `mismatched_uid`,
+     * `missing_dt_start`, `backwards_end`, `invalid_date_time`,
+     * `invalid_recurrence_rule`, `missing_recurrence_id`, `not_recurring` and
+     * `unknown_occurrence`.
+     *
+     * `errors` is present only when the request failed schema validation before any
+     * handler ran, and names every field that was refused.
+     */
+    400: ValidationError;
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+};
+
+export type UnifiedThreadOperationsListAllThreadsError = UnifiedThreadOperationsListAllThreadsErrors[keyof UnifiedThreadOperationsListAllThreadsErrors];
+
 export type UnifiedThreadOperationsListAllThreadsResponses = {
     /**
      * The request has succeeded.
@@ -5980,6 +7387,19 @@ export type ThreadDetailOperationsListThreadMessagesData = {
     url: '/threads/{threadId}/messages';
 };
 
+export type ThreadDetailOperationsListThreadMessagesErrors = {
+    /**
+     * The request carried no usable credential. `code` is `unauthorized`.
+     */
+    401: ApiError;
+    /**
+     * Nothing answers to this address, or the caller may not learn that something does. `code` is `not_found`.
+     */
+    404: ApiError;
+};
+
+export type ThreadDetailOperationsListThreadMessagesError = ThreadDetailOperationsListThreadMessagesErrors[keyof ThreadDetailOperationsListThreadMessagesErrors];
+
 export type ThreadDetailOperationsListThreadMessagesResponses = {
     /**
      * The request has succeeded.