@productcraft/mail 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -2001,7 +2001,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get one webhook endpoint (without its secret). */
+        /**
+         * Get one webhook endpoint (without its secret).
+         * @description The endpoint's URL, subscription, on/off state, failure streak and the last 4 characters of its signing secret. The full secret is only returned when the endpoint is created or its secret is rotated.
+         */
         get: operations["WebhooksController_mail_workspace_getEndpoint"];
         put?: never;
         post?: never;
@@ -2106,7 +2109,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get one webhook event with every delivery attempt. */
+        /**
+         * Get one webhook event with every delivery attempt.
+         * @description The event as it was sent (`type`, `data`) and every delivery attempt to every endpoint, with its trigger, HTTP status, error and the start of the response body. Use it to debug a receiver, then `replay` to send it again.
+         */
         get: operations["WebhooksController_mail_workspace_getEvent"];
         put?: never;
         post?: never;
@@ -2752,7 +2758,10 @@ interface components {
             visibility: "public" | "private";
         };
         CreateWebhookEndpointDto: {
-            /** @example Production receiver */
+            /**
+             * @description A label for people.
+             * @example Production receiver
+             */
             description?: string | null;
             /**
              * Format: uuid
@@ -2761,8 +2770,9 @@ interface components {
              */
             domain_id?: string | null;
             /**
-             * @description Create it switched off.
+             * @description Send `false` to create it switched off.
              * @default true
+             * @example true
              */
             enabled: boolean;
             /**
@@ -4304,15 +4314,19 @@ interface components {
             pagination: components["schemas"]["PaginationDto"];
         };
         ListWebhookEndpointsResponseDto: {
+            /** @description The endpoints, newest first. */
             data: components["schemas"]["WebhookEndpointDto"][];
             /** @description Always one page (an endpoint limit applies). */
             pagination: components["schemas"]["WebhookPaginationDto"];
         };
         ListWebhookEventTypesResponseDto: {
+            /** @description Every event type this product sends. */
             data: components["schemas"]["WebhookEventTypeDto"][];
         };
         ListWebhookEventsResponseDto: {
+            /** @description The events, newest first. */
             data: components["schemas"]["WebhookEventDto"][];
+            /** @description The cursor for the next page. */
             pagination: components["schemas"]["WebhookPaginationDto"];
         };
         LookupDmarcDto: {
@@ -4385,7 +4399,7 @@ interface components {
             reason: string;
         };
         /** @description Error codes this API returns (open set: a client must accept codes it does not know; new codes are not a breaking change). Each is documented at https://productcraft.co/docs/errors#<code>. */
-        MailErrorCode: ("BAD_REQUEST" | "VALIDATION_ERROR" | "UNAUTHORIZED" | "PAYMENT_REQUIRED" | "FORBIDDEN" | "NOT_FOUND" | "METHOD_NOT_ALLOWED" | "NOT_ACCEPTABLE" | "REQUEST_TIMEOUT" | "CONFLICT" | "GONE" | "PRECONDITION_FAILED" | "PAYLOAD_TOO_LARGE" | "UNSUPPORTED_MEDIA_TYPE" | "UNPROCESSABLE_ENTITY" | "PRECONDITION_REQUIRED" | "RATE_LIMITED" | "INTERNAL_SERVER_ERROR" | "NOT_IMPLEMENTED" | "BAD_GATEWAY" | "SERVICE_UNAVAILABLE" | "GATEWAY_TIMEOUT" | "SERVICE_NOT_ENABLED" | "INVALID_CREDENTIALS" | "SESSION_REVOKED" | "MCP_NOT_PERMITTED" | "MCP_WORKSPACE_MISMATCH" | "PAK_NOT_PERMITTED" | "ACTIONS_NOT_GRANTABLE" | "IDEMPOTENCY_KEY_REUSE" | "IDEMPOTENCY_KEY_REQUIRED" | "WEBHOOK_ENDPOINT_LIMIT" | "WEBHOOK_ENDPOINT_NOT_FOUND" | "WEBHOOK_ENDPOINT_NOT_SUBSCRIBED" | "WEBHOOK_EVENT_NOT_FOUND" | "WEBHOOK_EVENT_TYPE_UNKNOWN" | "AUDIENCE_REQUIRED" | "BROADCAST_AUDIENCE_EMPTY" | "BROADCAST_CONTENT_CONFLICT" | "BROADCAST_NOT_CANCELABLE" | "BROADCAST_NOT_DELETABLE" | "BROADCAST_NOT_DRAFT" | "BROADCAST_NOT_FOUND" | "BROADCAST_NOT_READY" | "CAPABILITY_NOT_VERIFIED" | "CONTACT_EXISTS" | "CONTACT_LIMIT" | "CONTACT_NOT_FOUND" | "CONTACT_PROPERTY_EXISTS" | "CONTACT_PROPERTY_LIMIT" | "CONTACT_PROPERTY_NOT_FOUND" | "DATE_RANGE_BEYOND_RETENTION" | "DATE_RANGE_TOO_WIDE" | "DATE_WINDOW_TOO_WIDE" | "DKIM_KEY_MISSING" | "DNS_CONFLICTS" | "DOMAIN_CONNECT_DISABLED" | "DOMAIN_CONNECT_MAIL_FROM_LABEL" | "DOMAIN_CONNECT_NOT_SENDING" | "DOMAIN_CONNECT_UNAVAILABLE" | "DOMAIN_HAS_MAILBOXES" | "DOMAIN_NOT_FOUND" | "EMAIL_UNAVAILABLE" | "FROM_DOMAIN_MISMATCH" | "IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW" | "IMPORT_IN_PROGRESS" | "IMPORT_NOT_FOUND" | "IMPORT_TOO_LARGE" | "INVALID_CAPABILITIES" | "INVALID_CONTACT_PROPERTY_VALUE" | "INVALID_CSV" | "INVALID_DATE" | "INVALID_DATE_RANGE" | "INVALID_DATE_WINDOW" | "INVALID_FORMAT" | "INVALID_FROM_ADDRESS" | "INVALID_SEGMENT_RULE" | "INVALID_TIMEZONE" | "INVALID_ZONE" | "MAIL_FROM_HOST_IN_USE" | "MAIL_FROM_NOT_SENDING" | "PROVIDER_ERROR" | "PROVIDER_PERMISSION_DENIED" | "PROVIDER_TOKEN_REJECTED" | "PROVIDER_UNAVAILABLE" | "PROVIDER_ZONE_NOT_FOUND" | "RECIPIENT_SUPPRESSED" | "REGION_NOT_AVAILABLE" | "RESERVED_PROPERTY_KEY" | "SEGMENT_EXISTS" | "SEGMENT_LIMIT" | "SEGMENT_NOT_FOUND" | "SEGMENT_RULE_BASED" | "SEGMENT_TYPE_FIXED" | "SES_IDENTITY_DELETE_FAILED" | "SHARE_LINK_NOT_FOUND" | "SMTP_AUTH_PARTIAL" | "SMTP_CONFIG_NOT_FOUND" | "SMTP_PASSWORD_REQUIRED" | "TEMPLATE_DATA_INVALID" | "TEMPLATE_KIND_NOT_SENDABLE" | "TEMPLATE_NOT_FOUND" | "TEMPLATE_RENDER_FAILED" | "TLS_ENFORCED_NOT_AVAILABLE" | "TOPIC_EXISTS" | "TOPIC_LIMIT" | "TOPIC_NOT_FOUND" | "TRACKING_NOT_AVAILABLE" | "UNKNOWN_CONTACT_PROPERTY" | "UNSUBSCRIBE_LINK_REQUIRED" | "domain_not_verified_by_provider" | "from_domain_not_verified" | "no_default_sender" | "sender_domain_not_in_workspace") | string;
+        MailErrorCode: ("BAD_REQUEST" | "VALIDATION_ERROR" | "UNAUTHORIZED" | "PAYMENT_REQUIRED" | "FORBIDDEN" | "NOT_FOUND" | "METHOD_NOT_ALLOWED" | "NOT_ACCEPTABLE" | "REQUEST_TIMEOUT" | "CONFLICT" | "GONE" | "PRECONDITION_FAILED" | "PAYLOAD_TOO_LARGE" | "UNSUPPORTED_MEDIA_TYPE" | "UNPROCESSABLE_ENTITY" | "PRECONDITION_REQUIRED" | "RATE_LIMITED" | "INTERNAL_SERVER_ERROR" | "NOT_IMPLEMENTED" | "BAD_GATEWAY" | "SERVICE_UNAVAILABLE" | "GATEWAY_TIMEOUT" | "SERVICE_NOT_ENABLED" | "INVALID_CREDENTIALS" | "SESSION_REVOKED" | "MCP_NOT_PERMITTED" | "MCP_WORKSPACE_MISMATCH" | "PAK_NOT_PERMITTED" | "ACTIONS_NOT_GRANTABLE" | "IDEMPOTENCY_KEY_REUSE" | "IDEMPOTENCY_KEY_REQUIRED" | "IDEMPOTENCY_IN_PROGRESS" | "WEBHOOK_ENDPOINT_LIMIT" | "WEBHOOK_ENDPOINT_NOT_FOUND" | "WEBHOOK_ENDPOINT_NOT_SUBSCRIBED" | "WEBHOOK_EVENT_NOT_FOUND" | "WEBHOOK_EVENT_TYPE_UNKNOWN" | "AUDIENCE_REQUIRED" | "BROADCAST_AUDIENCE_EMPTY" | "BROADCAST_CONTENT_CONFLICT" | "BROADCAST_NOT_CANCELABLE" | "BROADCAST_NOT_DELETABLE" | "BROADCAST_NOT_DRAFT" | "BROADCAST_NOT_FOUND" | "BROADCAST_NOT_READY" | "CAPABILITY_NOT_VERIFIED" | "CONTACT_EXISTS" | "CONTACT_LIMIT" | "CONTACT_NOT_FOUND" | "CONTACT_PROPERTY_EXISTS" | "CONTACT_PROPERTY_LIMIT" | "CONTACT_PROPERTY_NOT_FOUND" | "DATE_RANGE_BEYOND_RETENTION" | "DATE_RANGE_TOO_WIDE" | "DATE_WINDOW_TOO_WIDE" | "DKIM_KEY_MISSING" | "DNS_CONFLICTS" | "DOMAIN_CONNECT_DISABLED" | "DOMAIN_CONNECT_MAIL_FROM_LABEL" | "DOMAIN_CONNECT_NOT_SENDING" | "DOMAIN_CONNECT_UNAVAILABLE" | "DOMAIN_HAS_MAILBOXES" | "DOMAIN_NOT_FOUND" | "EMAIL_UNAVAILABLE" | "FROM_DOMAIN_MISMATCH" | "IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW" | "IMPORT_IN_PROGRESS" | "IMPORT_NOT_FOUND" | "IMPORT_TOO_LARGE" | "INVALID_CAPABILITIES" | "INVALID_CONTACT_PROPERTY_VALUE" | "INVALID_CSV" | "INVALID_DATE" | "INVALID_DATE_RANGE" | "INVALID_DATE_WINDOW" | "INVALID_FORMAT" | "INVALID_FROM_ADDRESS" | "INVALID_SEGMENT_RULE" | "INVALID_TIMEZONE" | "INVALID_ZONE" | "MAIL_FROM_HOST_IN_USE" | "MAIL_FROM_NOT_SENDING" | "PROVIDER_ERROR" | "PROVIDER_PERMISSION_DENIED" | "PROVIDER_TOKEN_REJECTED" | "PROVIDER_UNAVAILABLE" | "PROVIDER_ZONE_NOT_FOUND" | "RECIPIENT_SUPPRESSED" | "REGION_NOT_AVAILABLE" | "RESERVED_PROPERTY_KEY" | "SEGMENT_EXISTS" | "SEGMENT_LIMIT" | "SEGMENT_NOT_FOUND" | "SEGMENT_RULE_BASED" | "SEGMENT_TYPE_FIXED" | "SES_IDENTITY_DELETE_FAILED" | "SHARE_LINK_NOT_FOUND" | "SMTP_AUTH_PARTIAL" | "SMTP_CONFIG_NOT_FOUND" | "SMTP_PASSWORD_REQUIRED" | "TEMPLATE_DATA_INVALID" | "TEMPLATE_KIND_NOT_SENDABLE" | "TEMPLATE_NOT_FOUND" | "TEMPLATE_RENDER_FAILED" | "TLS_ENFORCED_NOT_AVAILABLE" | "TOPIC_EXISTS" | "TOPIC_LIMIT" | "TOPIC_NOT_FOUND" | "TRACKING_NOT_AVAILABLE" | "UNKNOWN_CONTACT_PROPERTY" | "UNSUBSCRIBE_LINK_REQUIRED" | "domain_not_verified_by_provider" | "from_domain_not_verified" | "no_default_sender" | "sender_domain_not_in_workspace") | string;
         MailStatsInWindowDto: {
             /**
              * @description Bounce rate, 0 to 1: bounced / emails sent (sent, delivered, deferred, bounced, complained — narrower than `sent` above, which also counts failed and suppressed). Null when nothing was sent.
@@ -5363,6 +5377,7 @@ interface components {
         ReplayWebhookEventResponseDto: {
             /** @description One attempt per endpoint it was sent to. */
             attempts: components["schemas"]["WebhookDeliveryAttemptDto"][];
+            /** @description The replayed event (the same id as the original). */
             event_id: string;
         };
         ResolvedBrandTokensDto: {
@@ -5402,6 +5417,7 @@ interface components {
             /**
              * @description Hours the previous secret keeps signing too (0 ends it now).
              * @default 24
+             * @example 24
              */
             grace_hours: number;
         };
@@ -6032,20 +6048,34 @@ interface components {
             visibility?: "public" | "private";
         };
         UpdateWebhookEndpointDto: {
+            /**
+             * @description A new label; null clears it.
+             * @example Production receiver
+             */
             description?: string | null;
             /**
              * Format: uuid
              * @description Domain filter; null removes it. Not allowed on a legacy slot (its domain is what makes it one).
              */
             domain_id?: string | null;
-            /** @description Switch it on or off. Switching on also clears an automatic disable. */
+            /**
+             * @description Switch it on or off. Switching on also clears an automatic disable.
+             * @example true
+             */
             enabled?: boolean;
-            /** @description Replaces the subscription. Event types from `GET …/webhooks/event-types`. Empty or omitted means every event, including types added later. Older names (`message.sent`, `message.delivered`, `message.deferred`, `message.bounced`, `message.complained`, `message.failed`) are still accepted; an endpoint subscribed under one receives the event with that name as its `type`. */
+            /**
+             * @description Replaces the subscription. Event types from `GET …/webhooks/event-types`. Empty or omitted means every event, including types added later. Older names (`message.sent`, `message.delivered`, `message.deferred`, `message.bounced`, `message.complained`, `message.failed`) are still accepted; an endpoint subscribed under one receives the event with that name as its `type`.
+             * @example [
+             *       "email.sent",
+             *       "email.delivered"
+             *     ]
+             */
             event_types?: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted" | "message.sent" | "message.delivered" | "message.deferred" | "message.bounced" | "message.complained" | "message.failed")[];
             /** @description Replaces the subscription. Older name for `event_types`, accepted and returned until the legacy webhook routes are retired (Sunset: 2027-01-15). Send one of the two. */
             events?: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted" | "message.sent" | "message.delivered" | "message.deferred" | "message.bounced" | "message.complained" | "message.failed")[];
             /**
              * Format: uri
+             * @description A new absolute https:// URL on a public host.
              * @example https://api.acme.com/webhooks
              */
             url?: string;
@@ -6153,26 +6183,47 @@ interface components {
             /** @description SMTP username. May be omitted alongside password for anonymous SMTP (e.g. postfix on a private network); otherwise both are required. */
             username?: string;
         };
+        /** @enum {string} */
+        WebhookAttemptTrigger: "automatic" | "replay" | "test";
         WebhookDeliveryAttemptDto: {
             /** @description 1 for the first delivery; retries and replays count up. */
             attempt_number: number;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the attempt was made.
+             */
             attempted_at: string;
             /**
              * Format: uuid
              * @description The endpoint's domain filter, if it has one.
              */
             domain_id: string | null;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The endpoint it was delivered to.
+             */
             endpoint_id: string;
-            /** @example request timed out */
+            /**
+             * @description Why the attempt failed when no 2xx came back; null on success.
+             * @example request timed out
+             */
             error_message: string | null;
-            /** @example evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f */
+            /**
+             * @description The event that was delivered.
+             * @example evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f
+             */
             event_id: string;
-            /** @example user.created */
+            /**
+             * @description The event's type.
+             * @example user.created
+             */
             event_type: string;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The attempt's id.
+             */
             id: string;
+            /** @description Milliseconds until the response; null when none came back. */
             latency_ms: number | null;
             /** @description The first 1 KiB of the response body. */
             response_body: string | null;
@@ -6182,28 +6233,36 @@ interface components {
             status_code: number | null;
             /** @description True for a 2xx response. */
             succeeded: boolean;
-            /**
-             * @description `automatic` (first delivery or a retry), `replay` or `test`.
-             * @enum {string}
-             */
-            trigger: "automatic" | "replay" | "test";
+            /** @description `automatic` (first delivery or a retry), `replay` or `test`. */
+            trigger: components["schemas"]["WebhookAttemptTrigger"];
             /**
              * Format: uri
              * @description Where it was sent.
              */
             url: string;
         };
+        /** @enum {string} */
+        WebhookEndpointDisabledReason: "manual" | "failing";
         WebhookEndpointDto: {
             /** @description Failed automatic deliveries in a row; a success resets it. */
             consecutive_failures: number;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the endpoint was created.
+             */
             created_at: string;
-            /** @example Production receiver */
+            /**
+             * @description A label for people; null when unset.
+             * @example Production receiver
+             */
             description: string | null;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When it was switched off; null while enabled.
+             */
             disabled_at: string | null;
-            /** @enum {string|null} */
-            disabled_reason: "manual" | "failing" | null;
+            /** @description `manual`: switched off by a caller. `failing`: switched off automatically after failed deliveries. Null while enabled. */
+            disabled_reason: components["schemas"]["WebhookEndpointDisabledReason"] | null;
             /**
              * Format: uuid
              * @description Only events about this domain; null for every event of the workspace.
@@ -6228,7 +6287,10 @@ interface components {
              * @description Start of the current failure streak.
              */
             first_failure_at: string | null;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The endpoint's id.
+             */
             id: string;
             /** @description True for endpoints carried over from the product's previous webhook system: they also receive the old signature header until its sunset date. */
             legacy_signature: boolean;
@@ -6256,30 +6318,42 @@ interface components {
              * @example x9Q=
              */
             signing_secret_hint: string;
+            /** @description `enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on. */
+            status: components["schemas"]["WebhookEndpointStatus"];
             /**
-             * @description `enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on.
-             * @enum {string}
+             * Format: date-time
+             * @description When the endpoint last changed.
              */
-            status: "enabled" | "disabled" | "auto_disabled";
-            /** Format: date-time */
             updated_at: string;
             /**
              * Format: uri
+             * @description Where events are sent.
              * @example https://api.acme.com/webhooks
              */
             url: string;
         };
+        /** @enum {string} */
+        WebhookEndpointStatus: "enabled" | "disabled" | "auto_disabled";
         WebhookEndpointWithSecretDto: {
             /** @description Failed automatic deliveries in a row; a success resets it. */
             consecutive_failures: number;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the endpoint was created.
+             */
             created_at: string;
-            /** @example Production receiver */
+            /**
+             * @description A label for people; null when unset.
+             * @example Production receiver
+             */
             description: string | null;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When it was switched off; null while enabled.
+             */
             disabled_at: string | null;
-            /** @enum {string|null} */
-            disabled_reason: "manual" | "failing" | null;
+            /** @description `manual`: switched off by a caller. `failing`: switched off automatically after failed deliveries. Null while enabled. */
+            disabled_reason: components["schemas"]["WebhookEndpointDisabledReason"] | null;
             /**
              * Format: uuid
              * @description Only events about this domain; null for every event of the workspace.
@@ -6304,7 +6378,10 @@ interface components {
              * @description Start of the current failure streak.
              */
             first_failure_at: string | null;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The endpoint's id.
+             */
             id: string;
             /** @description True for endpoints carried over from the product's previous webhook system: they also receive the old signature header until its sunset date. */
             legacy_signature: boolean;
@@ -6337,15 +6414,16 @@ interface components {
              * @example x9Q=
              */
             signing_secret_hint: string;
+            /** @description `enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on. */
+            status: components["schemas"]["WebhookEndpointStatus"];
             /**
-             * @description `enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on.
-             * @enum {string}
+             * Format: date-time
+             * @description When the endpoint last changed.
              */
-            status: "enabled" | "disabled" | "auto_disabled";
-            /** Format: date-time */
             updated_at: string;
             /**
              * Format: uri
+             * @description Where events are sent.
              * @example https://api.acme.com/webhooks
              */
             url: string;
@@ -6353,15 +6431,22 @@ interface components {
         WebhookEventDeliveryDto: {
             /** @description Number of the latest attempt; retries and replays count up. */
             attempt_number: number;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the latest attempt was made.
+             */
             attempted_at: string;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The endpoint.
+             */
             endpoint_id: string;
             /**
              * Format: date-time
              * @description When the next automatic attempt is due; null when none is queued.
              */
             next_attempt_at: string | null;
+            /** @description HTTP status of the latest attempt; null when no response came back. */
             status_code: number | null;
             /** @description True when the latest attempt got a 2xx. */
             succeeded: boolean;
@@ -6369,7 +6454,10 @@ interface components {
         WebhookEventDetailDto: {
             /** @description Every attempt, newest first. */
             attempts: components["schemas"]["WebhookDeliveryAttemptDto"][];
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the event happened.
+             */
             created_at: string;
             /** @description Latest attempt per endpoint (an endpoint whose first attempt is still queued is not listed yet). */
             deliveries: components["schemas"]["WebhookEventDeliveryDto"][];
@@ -6392,21 +6480,21 @@ interface components {
             payload: {
                 [key: string]: unknown;
             };
-            /**
-             * @description `pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed.
-             * @enum {string}
-             */
-            status: "pending" | "delivered" | "failed" | "not_sent";
+            /** @description `pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed. */
+            status: components["schemas"]["WebhookEventStatus"];
             /** @description Made by "Send test". */
             test: boolean;
             /**
+             * @description The event type (one of this product's catalogue).
              * @example email.sent
-             * @enum {string}
              */
-            type: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted";
+            type: components["schemas"]["WebhookEventType"];
         };
         WebhookEventDto: {
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the event happened.
+             */
             created_at: string;
             /** @description Latest attempt per endpoint (an endpoint whose first attempt is still queued is not listed yet). */
             deliveries: components["schemas"]["WebhookEventDeliveryDto"][];
@@ -6429,26 +6517,30 @@ interface components {
             payload: {
                 [key: string]: unknown;
             };
-            /**
-             * @description `pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed.
-             * @enum {string}
-             */
-            status: "pending" | "delivered" | "failed" | "not_sent";
+            /** @description `pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed. */
+            status: components["schemas"]["WebhookEventStatus"];
             /** @description Made by "Send test". */
             test: boolean;
             /**
+             * @description The event type (one of this product's catalogue).
              * @example email.sent
-             * @enum {string}
              */
-            type: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted";
+            type: components["schemas"]["WebhookEventType"];
         };
+        /** @enum {string} */
+        WebhookEventStatus: "pending" | "delivered" | "failed" | "not_sent";
+        /** @enum {string} */
+        WebhookEventType: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted";
         WebhookEventTypeDto: {
             /**
              * @description Group shown in the event picker.
              * @example Users
              */
             category: string;
-            /** @example A user signed up or was created by an admin. */
+            /**
+             * @description When this event is sent.
+             * @example A user signed up or was created by an admin.
+             */
             description: string;
             /** @description False for types that can be subscribed to but are not sent yet (scheduled sends, open and click tracking, inbound). */
             emitted: boolean;
@@ -6462,10 +6554,10 @@ interface components {
              */
             legacy_alias: string | null;
             /**
+             * @description The event type (one of this product's catalogue).
              * @example email.sent
-             * @enum {string}
              */
-            type: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted";
+            type: components["schemas"]["WebhookEventType"];
         };
         WebhookPaginationDto: {
             /** @description Whether another page follows. */
@@ -6922,6 +7014,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -6975,9 +7069,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -7181,6 +7277,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -7234,9 +7332,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -7367,6 +7467,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -7420,9 +7522,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -7743,6 +7847,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -7796,9 +7902,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Not a draft any more (`BROADCAST_NOT_DRAFT`, `details.status`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description Not a draft any more (`BROADCAST_NOT_DRAFT`, `details.status`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -7848,6 +7956,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -7901,9 +8011,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Draft, sent or already canceled (`BROADCAST_NOT_CANCELABLE`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description Draft, sent or already canceled (`BROADCAST_NOT_CANCELABLE`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -8025,6 +8137,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -8078,9 +8192,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -8214,6 +8330,8 @@ interface operations {
             /** @description `status` is `sending` or `scheduled`. */
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -8267,9 +8385,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Not a draft (`BROADCAST_NOT_DRAFT`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description Not a draft (`BROADCAST_NOT_DRAFT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -8408,6 +8528,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -8461,9 +8583,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description The key exists (`CONTACT_PROPERTY_EXISTS`), the workspace has 50 properties (`CONTACT_PROPERTY_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description The key exists (`CONTACT_PROPERTY_EXISTS`), the workspace has 50 properties (`CONTACT_PROPERTY_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -8680,6 +8804,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -8733,9 +8859,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -8878,6 +9006,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -8931,9 +9061,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A contact with this email exists (`CONTACT_EXISTS`), the workspace has 100,000 contacts (`CONTACT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description A contact with this email exists (`CONTACT_EXISTS`), the workspace has 100,000 contacts (`CONTACT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -9073,6 +9205,8 @@ interface operations {
             /** @description Queued. */
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -9126,9 +9260,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Two imports are already running (`IMPORT_IN_PROGRESS`), or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. */
+            /** @description Two imports are already running (`IMPORT_IN_PROGRESS`), or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -9440,6 +9576,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -9493,9 +9631,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -9631,6 +9771,8 @@ interface operations {
             /** @description Already a member; nothing changed. */
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -9647,6 +9789,8 @@ interface operations {
             /** @description Added. */
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -9700,9 +9844,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -9933,6 +10079,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -9986,9 +10134,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -10205,6 +10355,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -10258,9 +10410,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Domain already registered (globally unique); `MAIL_FROM_HOST_IN_USE`: the `custom_return_path` host already has records that are not ours (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. */
+            /** @description Domain already registered (globally unique); `MAIL_FROM_HOST_IN_USE`: the `custom_return_path` host already has records that are not ours (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -10582,6 +10736,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -10635,9 +10791,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `CAPABILITY_NOT_VERIFIED`: a verified domain cannot gain sending or receiving until the new records verify (`details.failing`, `details.records`); `DOMAIN_HAS_MAILBOXES`: receiving cannot be turned off while active mailboxes exist (`details.count`, `details.mailboxes[].id|address`); `MAIL_FROM_HOST_IN_USE`: the MAIL FROM host already has a CNAME, a foreign MX or a foreign SPF record (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description `CAPABILITY_NOT_VERIFIED`: a verified domain cannot gain sending or receiving until the new records verify (`details.failing`, `details.records`); `DOMAIN_HAS_MAILBOXES`: receiving cannot be turned off while active mailboxes exist (`details.count`, `details.mailboxes[].id|address`); `MAIL_FROM_HOST_IN_USE`: the MAIL FROM host already has a CNAME, a foreign MX or a foreign SPF record (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -10778,6 +10936,8 @@ interface operations {
             /** @description The plan (dry run), or the plan with each record's `result` and the post-apply DNS check. */
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -10831,9 +10991,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `DNS_CONFLICTS`: a blocking conflict (a second SPF record, a CNAME at the name, another DKIM key at our selector, other MX records at the MAIL FROM host or the domain, a merge over 10 SPF lookups). Nothing was written; the body carries the full `plan` and `conflicts`. Or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description `DNS_CONFLICTS`: a blocking conflict (a second SPF record, a CNAME at the name, another DKIM key at our selector, other MX records at the MAIL FROM host or the domain, a merge over 10 SPF lookups). Nothing was written; the body carries the full `plan` and `conflicts`. Or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -11065,6 +11227,8 @@ interface operations {
             /** @description The signed apply URL to open in the browser. */
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -11118,9 +11282,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description One-click setup is not possible for this domain; nothing was started. `DOMAIN_CONNECT_DISABLED`: ProductCraft has not switched Domain Connect on. `DOMAIN_CONNECT_UNAVAILABLE`: the DNS provider does not run Domain Connect or has not onboarded our template (`details.reason`: `no_record`, `settings_unreachable`, `template_not_onboarded` or `lookup_failed`; `details.provider_name`). `DOMAIN_CONNECT_NOT_SENDING`: a receive-only domain. `DOMAIN_CONNECT_MAIL_FROM_LABEL`: the MAIL FROM label is not `bounce` or MAIL FROM is off. `DKIM_KEY_MISSING`: no DKIM key to publish. Or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description One-click setup is not possible for this domain; nothing was started. `DOMAIN_CONNECT_DISABLED`: ProductCraft has not switched Domain Connect on. `DOMAIN_CONNECT_UNAVAILABLE`: the DNS provider does not run Domain Connect or has not onboarded our template (`details.reason`: `no_record`, `settings_unreachable`, `template_not_onboarded` or `lookup_failed`; `details.provider_name`). `DOMAIN_CONNECT_NOT_SENDING`: a receive-only domain. `DOMAIN_CONNECT_MAIL_FROM_LABEL`: the MAIL FROM label is not `bounce` or MAIL FROM is off. `DKIM_KEY_MISSING`: no DKIM key to publish. Or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -11338,6 +11504,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -11391,9 +11559,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the key was used with a different body. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the key was used with a different body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -11612,6 +11782,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -11665,9 +11837,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -11875,6 +12049,8 @@ interface operations {
             /** @description Accepted; queued for delivery. */
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -11928,9 +12104,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -12254,6 +12432,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -12307,9 +12487,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -12517,6 +12699,8 @@ interface operations {
             /** @description Saved. */
             204: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -12568,9 +12752,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -12609,6 +12795,8 @@ interface operations {
         responses: {
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -12662,9 +12850,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -12869,6 +13059,8 @@ interface operations {
             /** @description Disconnected. */
             204: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -12920,9 +13112,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -13050,6 +13244,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -13103,9 +13299,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Mailbox local-part already exists on this domain, or the domain is not yet verified, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. */
+            /** @description Mailbox local-part already exists on this domain, or the domain is not yet verified, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -13322,6 +13520,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -13375,9 +13575,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -14315,6 +14517,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -14368,9 +14572,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -15367,6 +15573,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -15420,9 +15628,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A segment with this name exists (`SEGMENT_EXISTS`), the workspace has 100 segments (`SEGMENT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description A segment with this name exists (`SEGMENT_EXISTS`), the workspace has 100 segments (`SEGMENT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -15734,6 +15944,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -15787,9 +15999,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Another segment has this name (`SEGMENT_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description Another segment has this name (`SEGMENT_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -16270,6 +16484,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -16323,9 +16539,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -16871,6 +17089,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -16924,9 +17144,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -17153,6 +17375,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -17206,9 +17430,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -17793,6 +18019,8 @@ interface operations {
             /** @description Send accepted; queued for delivery. */
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -17846,9 +18074,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description IDEMPOTENCY_KEY_REUSE — same key, different body. */
+            /** @description IDEMPOTENCY_KEY_REUSE — same key, different body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -17909,6 +18139,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -17962,9 +18194,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -18018,6 +18252,8 @@ interface operations {
         responses: {
             202: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -18071,9 +18307,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Cannot test-send a layout/partial, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. */
+            /** @description Cannot test-send a layout/partial, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -18301,6 +18539,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -18354,9 +18594,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A topic with this name exists (`TOPIC_EXISTS`), the workspace has 50 topics (`TOPIC_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description A topic with this name exists (`TOPIC_EXISTS`), the workspace has 50 topics (`TOPIC_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -18563,6 +18805,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -18616,9 +18860,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Another topic has this name (`TOPIC_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. */
+            /** @description Another topic has this name (`TOPIC_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -18914,6 +19160,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -18967,9 +19215,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -19098,6 +19348,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -19151,9 +19403,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -19280,6 +19534,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -19333,9 +19589,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -19466,6 +19724,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -19519,9 +19779,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. */
+            /** @description `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -19645,6 +19907,8 @@ interface operations {
         responses: {
             201: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -19698,9 +19962,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -19917,6 +20183,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -19970,9 +20238,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -20026,6 +20296,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -20079,9 +20351,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -20126,6 +20400,8 @@ interface operations {
             /** @description The attempt, successful or not. */
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -20179,9 +20455,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -20292,11 +20570,13 @@ interface operations {
                 type?: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.failed" | "email.suppressed" | "email.skipped" | "email.scheduled" | "email.canceled" | "email.opened" | "email.clicked" | "email.received" | "domain.created" | "domain.updated" | "domain.verified" | "domain.deleted" | "suppression.added" | "suppression.removed" | "sending_defaults.updated" | "contact.created" | "contact.updated" | "contact.deleted")[];
                 /** @description Only events sent (or queued) to this endpoint. */
                 endpoint_id?: string;
-                status?: "pending" | "delivered" | "failed" | "not_sent";
+                /** @description Only events in this delivery status. */
+                status?: components["schemas"]["WebhookEventStatus"];
                 /** @description Only events created at or after this instant. */
                 created_after?: string;
                 /** @description Only events created before this instant. */
                 created_before?: string;
+                /** @description Page size. */
                 limit?: number;
                 /** @description The previous page's `pagination.next_cursor`. */
                 cursor?: string;
@@ -20487,6 +20767,8 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    /** @description `true` when this response is a replay of an earlier request with the same `Idempotency-Key`. */
+                    "Idempotent-Replay"?: "true";
                     "X-RateLimit-Limit-long": components["headers"]["X-RateLimit-Limit-long"];
                     "X-RateLimit-Limit-short": components["headers"]["X-RateLimit-Limit-short"];
                     "X-RateLimit-Remaining-long": components["headers"]["X-RateLimit-Remaining-long"];
@@ -20540,9 +20822,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description `endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };