@veriko-mx/sdk 0.4.4 → 0.4.6

package/dist/cjs/generated/openapi.d.ts

@@ -1062,7 +1062,7 @@ export interface paths {
          *     {% callout type="warning" %}
          *     **Firma secreta:**\
          *     El `secret` de firma se devuelve **únicamente en esta respuesta** y no puede recuperarse después. Un secreto perdido se sustituye con `POST /v1/webhooks/{id}/regenerate-secret`, que devuelve el nuevo e invalida el anterior de inmediato — el endpoint no hay que volver a registrarlo.\
-         *     Ese secreto verifica cada entrega: el HMAC-SHA256 del cuerpo recibido debe coincidir con la cabecera `X-{Brand}-Signature: sha256=<hex>`.\
+         *     Ese secreto verifica cada entrega: el HMAC-SHA256 del cuerpo recibido debe coincidir con la cabecera `X-Webhook-Signature: sha256=<hex>`.\
          *     \
          *     La firma, y más detalles se describen en {% concept slug="webhooks-architecture" %}la arquitectura de webhooks{% /concept %}.
          *
@@ -1966,6 +1966,16 @@ export interface components {
             /** @description Identificador del recurso, único dentro de su `type`. Viaja siempre como cadena, incluso cuando su origen es una columna autonumérica. */
             id?: string;
         };
+        /**
+         * Format: date-time
+         * @description Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo,
+         *     `"2026-05-01T05:14:38Z"`.
+         *
+         *     Los campos `*_at`, `*_end`, `*_start` y `*_date` adoptan esta forma.
+         *     `meta.datetime` describe el mismo contrato en la respuesta.
+         * @example 2026-05-01T05:14:38Z
+         */
+        TimestampUTC: string;
         /** @description Conjunto consolidado del usuario autenticado que devuelve `GET /v1/users/me`: perfil, metadatos de la clave de API, suscripción activa, estado de la autenticación de 2 factores (2FA), permisos del rol y resumen de notificaciones en una sola llamada. */
         UserMeBundle: {
             /**
@@ -2118,16 +2128,6 @@ export interface components {
              */
             _warnings?: ("subscription_unavailable" | "permissions_unavailable" | "notifications_unread_count_unavailable" | "notifications_push_unavailable" | "notifications_telegram_unavailable" | "legal_accepted_unavailable")[];
         };
-        /**
-         * Format: date-time
-         * @description Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo,
-         *     `"2026-05-01T05:14:38Z"`.
-         *
-         *     Los campos `*_at`, `*_end`, `*_start` y `*_date` adoptan esta forma.
-         *     `meta.datetime` describe el mismo contrato en la respuesta.
-         * @example 2026-05-01T05:14:38Z
-         */
-        TimestampUTC: string;
         /** @description Política de reintentos de una validación: activación, límite, intervalo y resultados elegibles. */
         RetryPolicy: {
             /**
@@ -2165,12 +2165,12 @@ export interface components {
             fecha: string;
             /**
              * Format: double
-             * @description Importe de la transferencia (en pesos mexicanos — MXN), mayor que cero y con hasta dos decimales.
+             * @description Importe de la transferencia (en pesos mexicanos — MXN), mayor que cero y con hasta dos decimales. No se acepta en notación científica (por ejemplo `1e-5`) cuando se envía como texto.
              * @example 15000.5
              */
             monto: number;
             /**
-             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, guiones, diagonales y espacios. Requerida si `referencia_numerica` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
+             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, guiones, diagonales y espacios. Se recorta y se le quitan caracteres invisibles de ancho cero antes de validarse, para que la misma clave copiada y pegada compare igual en toda la plataforma. Requerida si `referencia_numerica` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
              * @example MXBA20250315001234
              */
             clave_rastreo?: string;
@@ -2190,7 +2190,7 @@ export interface components {
              */
             receptor?: string;
             /**
-             * @description Cuenta bancaria receptora de la transferencia. Puede ser CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos), y el tipo se identifica por la longitud. Para celular DiMo, si el banco receptor no puede resolverse por el campo `receptor`, por los beneficiarios registrados ni por el directorio de cuentas, la respuesta es un estado HTTP `422` (con `bank_code_unresolvable_for_phone` en el cuerpo).
+             * @description Cuenta bancaria receptora de la transferencia. Puede ser CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos), y el tipo se identifica por la longitud de sus dígitos. Los espacios y guiones que separan grupos ("0121 8000 4412 345678") se ignoran automáticamente antes de contar la longitud. Para celular DiMo, si el banco receptor no puede resolverse por el campo `receptor`, por los beneficiarios registrados ni por el directorio de cuentas, la respuesta es un estado HTTP `422` (con `bank_code_unresolvable_for_phone` en el cuerpo).
              * @example 012180004412345678
              */
             cuenta_beneficiaria?: string;
@@ -3719,30 +3719,30 @@ export interface components {
                  * @description URL receptora del webhook. En producción se rechaza si no usa HTTPS, si resuelve a una dirección privada o si pasa de 2048 caracteres.
                  * @example https://example.com/webhooks/entregas
                  */
-                url?: string;
+                url: string;
                 /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
-                events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
+                events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
                 /**
                  * @description Etiqueta libre para distinguir el endpoint webhook de los demás.
                  * @example Alta de pagos en el ERP
                  */
-                description?: string | null;
+                description: string | null;
                 /**
                  * @description Estado actual del webhook — `active`: Recibe entregas; `disabled`: Se desactivó manualmente; `auto_disabled`: Se desactivó automáticamente tras superar el umbral de fallos consecutivos.
                  * @example active
                  * @enum {string}
                  */
-                status?: "active" | "disabled" | "auto_disabled";
+                status: "active" | "disabled" | "auto_disabled";
                 /**
                  * @description Cantidad de fallos consecutivos. Se reinicia al primer éxito.
                  * @example 0
                  */
-                consecutive_failures?: number;
-                /** @description Fecha y hora del último intento de entrega, en ISO 8601 UTC. `null` cuando el endpoint aún no recibió ninguna entrega. */
-                last_delivery_at?: components["schemas"]["TimestampUTC"] | null;
+                consecutive_failures: number;
+                /** @description Fecha y hora de la última entrega exitosa, en ISO 8601 UTC. `null` cuando el endpoint aún no completó ninguna entrega. */
+                last_delivery_at: components["schemas"]["TimestampUTC"] | null;
                 /**
-                 * @description Clave compartida para verificar firmas. **Solo presente** en la respuesta de creación y de rotación del endpoint; se omite en cualquier otra respuesta.
-                 * @example whsec_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6
+                 * @description Clave compartida para verificar firmas. **Solo presente** en la respuesta de creación y de rotación del endpoint; se omite en cualquier otra respuesta. Se usa para validar la cabecera `X-Webhook-Signature` de cada entrega.
+                 * @example a0b1c2d3e4f5061728394a5b6c7d8e9f00112233445566778899aabbccddeeff
                  */
                 secret?: string;
                 /**
@@ -3750,9 +3750,9 @@ export interface components {
                  * @example ...4f2a
                  */
                 secret_hint?: string;
-                created_at?: components["schemas"]["TimestampUTC"];
-                updated_at?: components["schemas"]["TimestampUTC"];
-            };
+                created_at: components["schemas"]["TimestampUTC"];
+                updated_at: components["schemas"]["TimestampUTC"];
+            } & (unknown | unknown);
         };
         /** @description Cuerpo de `POST /v1/webhooks` con la URL HTTPS receptora, los eventos suscritos y una etiqueta opcional. */
         CreateWebhookRequest: {
@@ -3765,23 +3765,23 @@ export interface components {
             /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
             events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
-             * @description Etiqueta libre para distinguir el endpoint webhook de los demás.
+             * @description Etiqueta libre para distinguir el endpoint webhook de los demás. `null` la omite; más de 255 caracteres responde `422 webhook_description_too_long`.
              * @example Alta de pagos en el ERP
              */
-            description?: string;
+            description?: string | null;
         };
         /** @description Cuerpo de `PUT /v1/webhooks/{id}` con los campos del endpoint que deben actualizarse. */
         UpdateWebhookRequest: {
             /**
              * Format: uri
-             * @description Nueva URL receptora del webhook (endpoint). Es rechazada si no lleva protocolo seguro — HTTPS.
+             * @description Nueva URL receptora del webhook. En producción se rechaza si no usa HTTPS, si no resuelve a una dirección pública o si supera 2048 caracteres.
              * @example https://example.com/webhooks/entregas
              */
             url?: string;
             /** @description Nuevos eventos a los que se suscribe el endpoint webhook. Sustituyen a la lista anterior. Entre 1 y 10. */
             events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
-             * @description Nueva etiqueta libre para distinguir el endpoint webhook de los demás. `null` la elimina.
+             * @description Nueva etiqueta libre para distinguir el endpoint webhook de los demás. `null` la elimina; más de 255 caracteres responde `422 webhook_description_too_long`.
              * @example Alta de pagos en el ERP
              */
             description?: string | null;
@@ -3810,10 +3810,10 @@ export interface components {
              */
             response_time_ms: number;
             /**
-             * @description Detalle de la falla cuando `delivered=false`. `null` cuando la entrega fue exitosa.
+             * @description Detalle del fallo de transporte o de validación de URL. Puede ser `null` aunque `delivered=false` si el receptor respondió con un estado fuera de `2xx` pero la petición se completó.
              * @example Connection timed out after 10s
              */
-            error?: string | null;
+            error: string | null;
         };
         /** @description Recurso JSON:API de una entrega de webhook, con receptor, intento, respuesta y estado. */
         WebhookDelivery: components["schemas"]["JsonApiResourceBase"] & {
@@ -3835,7 +3835,7 @@ export interface components {
                  * @description Identificador único del endpoint webhook (UUID v4) que originó esta entrega.
                  * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
                  */
-                endpoint_id?: string;
+                endpoint_id: string;
                 /**
                  * @description URL receptora del webhook (endpoint). Solo presente en el listado global (`GET /v1/webhooks/deliveries`).
                  * @example https://erp.example.com/hooks/pagos
@@ -3846,47 +3846,47 @@ export interface components {
                  * @example validation.completed
                  * @enum {string}
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                event_type: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
                 /**
                  * Format: uuid
                  * @description Identificador único de la validación (UUID v4) asociada cuando el evento es `validation.*`. `null` cuando el evento es otro.
                  * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
                  */
-                validation_id?: string | null;
+                validation_id: string | null;
                 /**
                  * @description Código de estado HTTP con el que respondió el endpoint webhook receptor. `null` cuando la entrega no llegó a establecer respuesta (tiempo de espera agotado o bloqueo).
                  * @example 200
                  */
-                response_status?: number | null;
+                response_status: number | null;
                 /**
                  * @description Cuerpo de la respuesta del endpoint webhook receptor, truncado a 500 caracteres.
                  * @example {"ok":true}
                  */
-                response_body?: string | null;
+                response_body: string | null;
                 /**
                  * @description Duración de la petición de entrega (en milisegundos).
                  * @example 184
                  */
-                response_time_ms?: number | null;
+                response_time_ms: number | null;
                 /**
                  * @description Número del intento. `1` es el primer envío; los mayores, reintentos.
                  * @example 1
                  */
-                attempt?: number;
+                attempt: number;
                 /**
-                 * @description Estado actual de la entrega — `pending`: Aún sin entregar; `retrying`: Reintentando; `success`: Entregada; `failed`: Intentos agotados.
+                 * @description Estado actual de la entrega — `pending`: Aún sin entregar; `retrying`: Se pospuso por el límite de salida y Messenger la reintentará; `success`: Entregada; `failed`: El último intento falló; Messenger puede programar otro si el fallo es recuperable.
                  * @example pending
                  * @enum {string}
                  */
-                status?: "pending" | "retrying" | "success" | "failed";
-                /** @description Fecha y hora del próximo reintento programado, en ISO 8601 UTC. `null` cuando la entrega es terminal (entregada o agotada). */
-                next_retry_at?: components["schemas"]["TimestampUTC"] | null;
+                status: "pending" | "retrying" | "success" | "failed";
+                /** @description Fecha y hora del próximo reintento persistido, en ISO 8601 UTC. `null` cuando no hay una fecha almacenada; los reintentos que programa Messenger no persisten esta fecha en la entrega. */
+                next_retry_at: components["schemas"]["TimestampUTC"] | null;
                 /**
-                 * @description Mensaje de error del intento de entrega. `null` cuando la entrega llegó al receptor.
+                 * @description Detalle de error del transporte o del bloqueo de la entrega. `null` cuando no hay un detalle de error, incluso si el receptor respondió con un estado fuera de `2xx`.
                  * @example Connection timed out after 10s
                  */
-                error_message?: string | null;
-                created_at?: components["schemas"]["TimestampUTC"];
+                error_message: string | null;
+                created_at: components["schemas"]["TimestampUTC"];
             };
         };
         /** @description Característica bilingüe de un plan, con indicador visual, orden y estado. */
@@ -4992,11 +4992,20 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "f7a8b9c0d1e2"
+                 *         "request_id": "f7a8b9c0d1e2",
+                 *         "retry_after": 45
                  *       }
                  *     }
                  */
-                "application/json": components["schemas"]["ErrorResponse"];
+                "application/json": components["schemas"]["ErrorResponse"] & {
+                    meta?: {
+                        /**
+                         * @description Segundos a esperar antes de reintentar. Es el mismo valor que la cabecera `Retry-After`, para clientes que no leen cabeceras HTTP.
+                         * @example 45
+                         */
+                        retry_after?: number;
+                    };
+                };
             };
         };
         /** @description Validación asíncrona aceptada. Se debe sondear `GET /v1/validations/{id}` hasta uno de los estados terminales (`valid`, `not_found`, `cep_unavailable`, `invalid`, `returned`, `failed`, `error`). `meta.next_poll_after_seconds` indica el intervalo recomendado para el primer sondeo. */
@@ -5238,7 +5247,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             409: components["responses"]["IdempotencyKeyInProgress"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description Falló la validación de la petición. Códigos típicos: `clave_or_ref_required`, `required` (fecha/monto), `invalid_date`, `invalid_amount`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `invalid_receptor_participante`, `retry_policy_invalid`, `retry_pending_cap_exceeded`. También se emite cuando se reutiliza `Idempotency-Key` con un cuerpo distinto (`idempotency_key_reused`). */
+            /** @description Falló la validación de la petición. Códigos típicos: `clave_or_ref_required`, `required` (fecha/monto), `invalid_date`, `invalid_amount`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `invalid_bank_code` (`emisor`/`receptor` no reconocidos), `intra_bank_no_cep` (emisor y receptor son el mismo banco), `invalid_field_type` (un campo que debe ser texto llegó como arreglo u objeto — p. ej. `emisor`, `receptor` o `referencia_numerica`), `invalid_receptor_participante`, `retry_policy_invalid`, `retry_pending_cap_exceeded`. También se emite cuando se reutiliza `Idempotency-Key` con un cuerpo distinto (`idempotency_key_reused`). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -5341,17 +5350,17 @@ export interface operations {
                  */
                 type?: "direct" | "ocr";
                 /**
-                 * @description Filtro — Fecha inicial inclusiva, aplicada sobre la creación de la validación.
+                 * @description Filtro — Fecha inicial inclusiva, aplicada sobre la creación de la validación. Enviarlo como lista (`from[]=`) devuelve un estado HTTP `422` con `invalid_filter`.
                  * @example 2025-01-01
                  */
                 from?: string;
                 /**
-                 * @description Filtro — Fecha final inclusiva, aplicada sobre la creación de la validación.
+                 * @description Filtro — Fecha final inclusiva, aplicada sobre la creación de la validación. Enviarlo como lista (`to[]=`) devuelve un estado HTTP `422` con `invalid_filter`.
                  * @example 2025-03-31
                  */
                 to?: string;
                 /**
-                 * @description Filtro — Texto buscado, sin distinguir mayúsculas y minúsculas, en los datos enviados, normalizados y devueltos por Banxico. `%` y `_` se tratan como caracteres literales.
+                 * @description Filtro — Texto buscado, sin distinguir mayúsculas y minúsculas, en los datos enviados, normalizados y devueltos por Banxico. `%` y `_` se tratan como caracteres literales, y los 100 caracteres se cuentan por carácter (no por byte), así que un acento no se parte a la mitad. Si el texto, sin espacios ni guiones, queda compuesto sólo por dígitos, también se busca esa forma sin separadores contra la cuenta beneficiaria.
                  * @example scotiabank
                  */
                 search?: string;
@@ -5366,22 +5375,22 @@ export interface operations {
                  */
                 with_deleted?: "0" | "1";
                 /**
-                 * @description Filtro — Identificador del trabajo de importación que generó las validaciones.
+                 * @description Filtro — Identificador del trabajo de importación que generó las validaciones. Enviarlo como lista (`batch_id[]=`) devuelve un estado HTTP `422` con `invalid_filter` en vez de ignorarse.
                  * @example 42
                  */
                 batch_id?: number;
                 /**
-                 * @description Filtro — Clave SPEI del banco emisor o receptor en la petición original. Los valores que no tengan de 1 a 5 dígitos se ignoran.
+                 * @description Filtro — Clave SPEI del banco emisor o receptor en la petición original. Los valores que no tengan de 1 a 5 dígitos se ignoran; enviarlo como lista (`bank[]=`) devuelve un estado HTTP `422` con `invalid_filter`.
                  * @example 012
                  */
                 bank?: string;
                 /**
-                 * @description Filtro — Importe mínimo inclusivo. Se aplica de forma independiente de `amount_max`.
+                 * @description Filtro — Importe mínimo inclusivo, como número. El servidor también tolera enviarlo como texto con separador de miles o símbolo de moneda ("1,000.50", "$500") y lo normaliza con el mismo algoritmo que el resto de la plataforma, pero el contrato es un número: un cliente tipado debe mandarlo así. Un valor no vacío que no se reconozca como número devuelve un estado HTTP `422` con `invalid_filter`, en vez de ignorarse en silencio. Se aplica de forma independiente de `amount_max`.
                  * @example 1000.5
                  */
                 amount_min?: number;
                 /**
-                 * @description Filtro — Importe máximo inclusivo. Se aplica de forma independiente de `amount_min`.
+                 * @description Filtro — Importe máximo inclusivo, como número. Mismas reglas de tolerancia de formato y de error que `amount_min`. Se aplica de forma independiente de `amount_min`.
                  * @example 50000
                  */
                 amount_max?: number;
@@ -5421,7 +5430,7 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
-            /** @description Valor inválido para `retry_state` (código `invalid_filter`). */
+            /** @description Un filtro no se pudo aplicar (código `invalid_filter`): valor no admitido en `retry_state`, `playground` o `amount_min`/`amount_max` con formato irreconocible; o tipo incorrecto en `from`, `to`, `search`, `bank` o `batch_id` (por ejemplo, enviados como lista `from[]=`). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6291,7 +6300,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `beneficiary_already_registered` y `plan_cap_exceeded`. */
+            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `account_number_invalid_type`, `label_invalid_type`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `beneficiary_already_registered` y `plan_cap_exceeded`. `account_number_invalid_type` y `label_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto. Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6366,7 +6375,7 @@ export interface operations {
             403: components["responses"]["Forbidden"];
             404: components["responses"]["NotFound"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_length`, `clabe_prefix_not_recognized` y `bank_code_required_for_phone`. */
+            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `account_number_invalid_type` y `label_invalid_type`. Las dos últimas aparecen cuando `account_number` o `label` llegan con un tipo distinto de cadena de texto (por ejemplo, un número o un arreglo). Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7194,7 +7203,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Endpoint webhook creado. El campo `secret` aparece **solo en esta respuesta** y no puede volver a consultarse: es el que verifica la firma `X-{Brand}-Signature: sha256=<hex>` que acompaña a cada entrega. */
+            /** @description Endpoint webhook creado. El campo `secret` aparece **solo en esta respuesta** y no puede volver a consultarse: es el que verifica la firma `X-Webhook-Signature: sha256=<hex>` que acompaña a cada entrega. */
             201: {
                 headers: {
                     [name: string]: unknown;
@@ -7217,7 +7226,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description La URL o la lista de eventos no superan la validación, o la cuenta de usuario alcanzó su tope de endpoints. */
+            /** @description La URL, la lista de eventos o `description` no superan la validación, o la cuenta de usuario alcanzó su tope de endpoints. `webhook_url_invalid_type` y `webhook_description_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto; `webhook_description_too_long` cuando `description` excede 255 caracteres. Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7268,7 +7277,7 @@ export interface operations {
                     };
                 };
             };
-            /** @description El cuerpo de la petición está vacío o no es JSON válido. */
+            /** @description El cuerpo de la petición está vacío o no es JSON válido, o la URL nueva no resuelve a una dirección pública. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7289,7 +7298,7 @@ export interface operations {
                 };
             };
             413: components["responses"]["PayloadTooLarge"];
-            /** @description Datos inválidos. Códigos posibles: `webhook_url_empty`, `webhook_url_too_long`, `webhook_url_invalid_format`, `webhook_url_not_https`, `webhook_events_required`, `webhook_events_too_many`, `webhook_event_invalid`, `webhook_status_invalid`, `no_valid_fields`. */
+            /** @description Datos inválidos. Códigos posibles: `webhook_url_invalid_type`, `webhook_url_empty`, `webhook_url_too_long`, `webhook_url_invalid_format`, `webhook_url_not_https`, `webhook_events_required`, `webhook_events_too_many`, `webhook_event_invalid`, `webhook_description_invalid_type`, `webhook_description_too_long`, `webhook_status_invalid`, `no_valid_fields`. Una `description` de más de 255 caracteres responde `webhook_description_too_long`. Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7477,6 +7486,7 @@ export interface operations {
                 };
                 content: {
                     "text/csv": string;
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": string;
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -7544,7 +7554,7 @@ export interface operations {
                  */
                 endpoint_id?: string;
                 /**
-                 * @description Filtro — Desenlace del intento de entrega. `success` llegó. `failed` no llegó y ya no se reintenta. `retrying` falló pero queda algún intento. `pending` todavía no se ha intentado.
+                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
                  * @example failed
                  */
                 status?: "success" | "failed" | "retrying" | "pending";
@@ -7599,7 +7609,7 @@ export interface operations {
                 endpoint_id?: string;
                 /**
                  * @description \
-                 *     Filtro — Desenlace del intento de entrega. `success` llegó. `failed` no llegó y ya no se reintenta. `retrying` falló pero queda algún intento. `pending` todavía no se ha intentado.
+                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
                  * @example failed
                  */
                 status?: "success" | "failed" | "retrying" | "pending";
@@ -7633,6 +7643,7 @@ export interface operations {
                 };
                 content: {
                     "text/csv": string;
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": string;
                 };
             };
             401: components["responses"]["Unauthorized"];