@productcraft/trawl 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -435,7 +435,10 @@ interface components {
             url: string;
         };
         CreateWebhookEndpointDto: {
-            /** @example Production receiver */
+            /**
+             * @description A label for people.
+             * @example Production receiver
+             */
             description?: string | null;
             /**
              * @description Create it switched off.
@@ -458,14 +461,20 @@ interface components {
             url: string;
         };
         CreditLedgerEntryDto: {
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description When the entry was recorded.
+             */
             created_at: string;
             /**
              * @description Steps added (positive: allowance, top-up, grant) or used (negative: a job).
              * @example -12
              */
             delta_steps: number;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The entry's id.
+             */
             id: string;
             /**
              * Format: uuid
@@ -497,78 +506,158 @@ interface components {
              */
             low_balance_threshold_steps: number;
         };
-        ErrorResponseDto: {
+        ErrorParamDto: {
             /**
-             * @description Stable, machine-readable error code; branch on this, not on `message`. Always present. A route-specific code when the route defines one (e.g. `WEBHOOK_ENDPOINT_NOT_FOUND`, `SERVICE_NOT_ENABLED`), otherwise the generic code for the status: `BAD_REQUEST`, `VALIDATION_ERROR` (400 from request validation), `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `PAYLOAD_TOO_LARGE`, `UNPROCESSABLE_ENTITY`, `RATE_LIMITED`, `INTERNAL_SERVER_ERROR`, `SERVICE_UNAVAILABLE`.
-             * @example SERVICE_NOT_ENABLED
+             * @description The failed rule (class-validator constraint name, e.g. `isEmail`, `isUuid`, `whitelistValidation` for a field the operation does not declare), or `invalid`.
+             * @example isEmail
              */
             code: string;
             /**
-             * @description Human-readable error message. May be a class-validator array on 400.
-             * @example Policy denies trawl.read on pcft:workspace/7a0c2f7e-2b8d-4f7f-9a51-3f1f0e1f3c11
+             * @description What is wrong with it; the same text as the field's entry in an array `message`.
+             * @example email must be an email
+             */
+            message: string;
+            /**
+             * @description Wire path of the invalid field: `email`, `items.0.display_name`.
+             * @example email
+             */
+            param: string;
+        };
+        ErrorResponseDto: {
+            /**
+             * @description Stable, machine-readable error code; branch on this, not on `message`. Always present. A route-specific code when the route defines one, otherwise the generic code for the status (`NOT_FOUND`, `VALIDATION_ERROR`, `RATE_LIMITED`, ...). Open set: accept codes you do not know. Each code is documented at https://productcraft.co/docs/errors#<code>.
+             * @example NOT_FOUND
+             */
+            code: components["schemas"]["TrawlErrorCode"];
+            /**
+             * @description Structured context for errors a client has to act on, keyed in snake_case and specific to the code (e.g. `{ fqdn, reason }` on `from_domain_not_verified`). Absent on most errors.
+             * @example {
+             *       "fqdn": "mail.example.com",
+             *       "reason": "not_verified"
+             *     }
+             */
+            details?: {
+                [key: string]: unknown;
+            };
+            /** @description One entry per invalid request field on a `VALIDATION_ERROR`; empty on every other error. */
+            errors: components["schemas"]["ErrorParamDto"][];
+            /**
+             * @description Human-readable error message. A string, or on a `VALIDATION_ERROR` an array with one message per invalid field (the same texts as `errors[].message`). Branch on `code`, not on this.
+             * @example Domain not found
              */
             message: string | string[];
+            /**
+             * @description The request's id, same as the `X-Request-Id` response header. Quote it when contacting support.
+             * @example req_6f1c2a9d4b7e4f0a8c3d2e1f0a9b8c7d
+             */
+            request_id: string;
             /**
              * @deprecated
              * @description Deprecated alias of `status_code`, same value. Kept so existing clients keep working; read `status_code`. Error responses carry `Deprecation: true` while it is sent.
-             * @example 403
+             * @example 404
              */
             statusCode?: number;
             /**
-             * @description HTTP status code echoed in the body (`status_code`). `statusCode` carries the same value as a deprecated alias.
-             * @example 403
+             * @description HTTP status code, same as the response status.
+             * @example 404
              */
             status_code: number;
         };
         JobListPaginationDto: {
+            /** @description Whether another page follows. */
             has_more: boolean;
+            /** @description Pass as `cursor` to get the next page; null on the last page. */
             next_cursor: string | null;
         };
         JobListResponseDto: {
+            /** @description The jobs, newest first. */
             data: components["schemas"]["JobResponseDto"][];
+            /** @description The cursor for the next page. */
             pagination: components["schemas"]["JobListPaginationDto"];
         };
         JobResponseDto: {
+            /** @description How many times a worker has picked the job up. */
             attempts: number;
+            /**
+             * Format: date-time
+             * @description When it ended; null until then.
+             */
             completed_at: string | null;
+            /**
+             * Format: date-time
+             * @description When the job was created.
+             */
             created_at: string;
+            /** @description Natural-language description of what to extract. */
             description: string;
+            /**
+             * Format: date-time
+             * @description When the job was queued.
+             */
             enqueued_at: string;
+            /** @description Why the job failed; null unless `status` is `failed`. */
             error: string | null;
+            /**
+             * Format: uuid
+             * @description The job's id.
+             */
             id: string;
             /** @description The JSON Schema the job was created with. */
             json_schema: {
                 [key: string]: unknown;
             };
+            /** @description Maximum number of agent steps (one LLM call each) before the job stops. */
             max_steps: number;
+            /** @description Model tier the worker uses (e.g. `standard`, `pro`). */
             model_tier: string;
             /** @description The extracted data, shaped by `json_schema`. Null until the job succeeds. */
             result: {
                 [key: string]: unknown;
             } | null;
+            /**
+             * Format: date-time
+             * @description When a worker started it; null while queued.
+             */
             started_at: string | null;
-            /** @enum {string} */
-            status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
+            /** @description `queued` until a worker picks it up, then `running`; it ends `succeeded` (the result is in `result`), `failed` (see `error`) or `cancelled`. */
+            status: components["schemas"]["JobStatus"];
+            /** @description Seed URLs the worker starts from; null when none were given. */
             suggested_urls: string[] | null;
+            /** @description Wall-clock timeout for the job, in seconds. */
             timeout_s: number;
+            /**
+             * Format: uuid
+             * @description The webhook endpoint named at creation to notify when the job ends; null when none.
+             */
             webhook_id: string | null;
+            /**
+             * Format: uuid
+             * @description The workspace that owns the job.
+             */
             workspace_id: string;
         };
+        /** @enum {string} */
+        JobStatus: "queued" | "running" | "succeeded" | "failed" | "cancelled";
         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"];
         };
         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;
         };
         RotateWebhookSecretDto: {
@@ -586,6 +675,12 @@ interface components {
              */
             event_type: "job.succeeded" | "job.failed" | "credits.low";
         };
+        /** @enum {string} */
+        StatsGranularity: "day";
+        /** @enum {string} */
+        StatsWindow: "1d" | "7d" | "30d";
+        /** @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>. */
+        TrawlErrorCode: ("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" | "TOO_MANY_ACTIVE_JOBS" | "TRAWL_CREDITS_EXHAUSTED") | string;
         TrawlStatsInWindowDto: {
             /**
              * @description Of those, jobs that failed.
@@ -608,19 +703,19 @@ interface components {
              */
             succeeded: number;
         };
+        /** @enum {string} */
+        TrawlStatsMetric: "jobs";
         TrawlStatsSeriesDto: {
             /**
              * @description Bucket width.
              * @example day
-             * @enum {string}
              */
-            granularity: "day";
+            granularity: components["schemas"]["StatsGranularity"];
             /**
              * @description Jobs created per UTC day in the workspace, in any status.
              * @example jobs
-             * @enum {string}
              */
-            metric: "jobs";
+            metric: components["schemas"]["TrawlStatsMetric"];
             /** @description Dense and zero-filled: one point per UTC day in the window, oldest first, ending today. */
             points: components["schemas"]["TrawlStatsSeriesPointDto"][];
         };
@@ -671,9 +766,8 @@ interface components {
             /**
              * @description Window the counts cover.
              * @example 30d
-             * @enum {string}
              */
-            window: "1d" | "7d" | "30d";
+            window: components["schemas"]["StatsWindow"];
         };
         UpdateWebhookDto: {
             /** @description Pause/resume the webhook. Setting active=true clears auto-disable. */
@@ -682,6 +776,7 @@ interface components {
             url?: string;
         };
         UpdateWebhookEndpointDto: {
+            /** @description A new label; null clears it. */
             description?: string | null;
             /** @description Switch it on or off. Switching on also clears an automatic disable. */
             enabled?: boolean;
@@ -689,10 +784,13 @@ interface components {
             event_types?: ("job.succeeded" | "job.failed" | "credits.low")[];
             /**
              * Format: uri
+             * @description A new absolute https:// URL on a public host.
              * @example https://api.acme.com/webhooks
              */
             url?: string;
         };
+        /** @enum {string} */
+        WebhookAttemptTrigger: "automatic" | "replay" | "test";
         WebhookCreateResponseDto: {
             /** @description Whether it receives events (`enabled` on the new routes). */
             active: boolean;
@@ -727,18 +825,37 @@ interface components {
         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 */
+            /**
+             * 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;
@@ -746,11 +863,8 @@ 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.
@@ -782,17 +896,28 @@ interface components {
             /** Format: uuid */
             webhook_id: 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;
             /** @description The on/off switch (`PATCH … { enabled }`). */
             enabled: boolean;
             /**
@@ -805,7 +930,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;
@@ -828,30 +956,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;
             /** @description The on/off switch (`PATCH … { enabled }`). */
             enabled: boolean;
             /**
@@ -864,7 +1004,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;
@@ -892,15 +1035,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;
@@ -908,15 +1052,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;
@@ -924,7 +1075,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"][];
@@ -937,21 +1091,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 job.succeeded
-             * @enum {string}
              */
-            type: "job.succeeded" | "job.failed" | "credits.low";
+            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"][];
@@ -964,36 +1118,40 @@ 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 job.succeeded
-             * @enum {string}
              */
-            type: "job.succeeded" | "job.failed" | "credits.low";
+            type: components["schemas"]["WebhookEventType"];
         };
+        /** @enum {string} */
+        WebhookEventStatus: "pending" | "delivered" | "failed" | "not_sent";
+        /** @enum {string} */
+        WebhookEventType: "job.succeeded" | "job.failed" | "credits.low";
         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 An example `data` object; "Send test" delivers exactly this. */
             example: {
                 [key: string]: unknown;
             };
             /**
+             * @description The event type (one of this product's catalogue).
              * @example job.succeeded
-             * @enum {string}
              */
-            type: "job.succeeded" | "job.failed" | "credits.low";
+            type: components["schemas"]["WebhookEventType"];
         };
         WebhookListPaginationDto: {
             has_more: boolean;
@@ -1052,7 +1210,28 @@ interface components {
     responses: never;
     parameters: never;
     requestBodies: never;
-    headers: never;
+    headers: {
+        /** @description The request's id: the inbound `X-Request-Id` when it is 1 to 128 characters of `A-Z a-z 0-9 . _ : -`, otherwise a fresh `req_...` id. Error bodies repeat it as `request_id`. Quote it when contacting support. */
+        RequestId: string;
+        /** @description Seconds to wait before retrying. Sent on every 429. */
+        "Retry-After": number;
+        /** @description Seconds to wait, when the per-minute IP limit tripped. */
+        "Retry-After-long": number;
+        /** @description Seconds to wait, when the per-second IP limit tripped. */
+        "Retry-After-short": number;
+        /** @description Requests allowed per minute from this client IP (600). */
+        "X-RateLimit-Limit-long": number;
+        /** @description Requests allowed per second from this client IP (20). */
+        "X-RateLimit-Limit-short": number;
+        /** @description Requests left in the current one-minute window. */
+        "X-RateLimit-Remaining-long": number;
+        /** @description Requests left in the current one-second window. */
+        "X-RateLimit-Remaining-short": number;
+        /** @description Seconds until the one-minute window resets. */
+        "X-RateLimit-Reset-long": number;
+        /** @description Seconds until the one-second window resets. */
+        "X-RateLimit-Reset-short": number;
+    };
     pathItems: never;
 }
 interface operations {
@@ -1064,6 +1243,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1073,6 +1253,13 @@ interface operations {
             /** @description Balance, low-balance state and recent entries. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1082,6 +1269,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1091,6 +1279,20 @@ interface operations {
             /** @description Caller lacks `trawl.read`, or the service is not enabled. */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1103,13 +1305,15 @@ interface operations {
         parameters: {
             query?: {
                 /** @description Filter by job status. */
-                status?: "queued" | "running" | "succeeded" | "failed" | "cancelled";
+                status?: components["schemas"]["JobStatus"];
                 /** @description Opaque cursor for pagination. */
                 cursor?: string;
+                /** @description Page size. */
                 limit?: number;
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1119,6 +1323,13 @@ interface operations {
             /** @description Page of jobs with pagination cursor. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1128,6 +1339,20 @@ interface operations {
             /** @description Caller lacks `trawl.list`, or workspace has not enabled the `trawl` service. */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1144,6 +1369,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1157,6 +1383,15 @@ interface operations {
             /** @description Job created and queued. */
             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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1166,6 +1401,7 @@ interface operations {
             /** @description Invalid JSON Schema (must be a non-empty `type: object`). */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1175,15 +1411,32 @@ interface operations {
             /** @description Caller lacks `trawl.create`, or workspace has not enabled the `trawl` service. */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Rate limited. `RATE_LIMITED` — submission window exceeded (default 10/min per workspace); the `Retry-After` header gives the seconds until the window resets. `TOO_MANY_ACTIVE_JOBS` — too many queued/running jobs (default 25); retry once some finish. */
+            /** @description 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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Rate limited. `RATE_LIMITED` — submission window exceeded (default 10/min per workspace); the `Retry-After` header gives the seconds until the window resets. `TOO_MANY_ACTIVE_JOBS` — too many queued/running jobs (default 25); retry once some finish. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
             429: {
                 headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1197,7 +1450,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the job. */
                 id: string;
             };
             cookie?: never;
@@ -1207,6 +1462,13 @@ interface operations {
             /** @description Job row. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1216,6 +1478,20 @@ interface operations {
             /** @description Job not found in this workspace. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1229,7 +1505,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the job. */
                 id: string;
             };
             cookie?: never;
@@ -1239,6 +1517,13 @@ interface operations {
             /** @description Job cancelled. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1248,6 +1533,7 @@ interface operations {
             /** @description Job not found in this workspace. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1257,6 +1543,20 @@ interface operations {
             /** @description Job is already in a terminal state and cannot be cancelled. */
             422: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1269,7 +1569,7 @@ interface operations {
         parameters: {
             query?: {
                 /** @description Window for `in_window` and the length of `series`, in UTC days ending today. */
-                window?: "1d" | "7d" | "30d";
+                window?: components["schemas"]["StatsWindow"];
             };
             header?: never;
             path: {
@@ -1283,6 +1583,13 @@ interface operations {
             /** @description Trawl stats. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1292,6 +1599,7 @@ interface operations {
             /** @description `window` is not one of 1d, 7d, 30d. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1301,6 +1609,7 @@ interface operations {
             /** @description Caller lacks `trawl.read` on the workspace, or Trawl is not enabled on it (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1310,6 +1619,20 @@ interface operations {
             /** @description Workspace not found: the id is unknown, is not a UUID, or is not visible to the caller. Same answer as the service's other workspace routes. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1328,6 +1651,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1337,6 +1661,13 @@ interface operations {
             /** @description Page of webhooks with a pagination cursor. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1346,6 +1677,20 @@ interface operations {
             /** @description Invalid cursor or limit. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1362,6 +1707,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1375,6 +1721,15 @@ interface operations {
             /** @description Webhook created. Includes plaintext `signing_secret` exactly once. */
             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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1384,15 +1739,32 @@ interface operations {
             /** @description Invalid URL (must be public HTTPS). */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description The workspace already has 10 webhooks. */
+            /** @description The workspace already has 10 webhooks. 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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1406,6 +1778,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1414,6 +1787,13 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1423,6 +1803,7 @@ interface operations {
             /** @description The scope id in the path is malformed. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1432,6 +1813,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1441,6 +1823,20 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1457,6 +1853,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1469,6 +1866,15 @@ 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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1478,6 +1884,7 @@ interface operations {
             /** @description Validation failure: URL not https with a public host, or an unknown event type (`WEBHOOK_EVENT_TYPE_UNKNOWN`). */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1487,6 +1894,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1496,15 +1904,19 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "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;
                 };
                 content: {
@@ -1514,6 +1926,20 @@ interface operations {
             /** @description The URL points at a private, loopback or internal address. */
             422: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1527,7 +1953,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the endpoint. */
                 endpoint_id: string;
             };
             cookie?: never;
@@ -1536,6 +1964,13 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1545,6 +1980,7 @@ interface operations {
             /** @description `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1554,6 +1990,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1563,6 +2000,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1572,6 +2010,20 @@ interface operations {
             /** @description No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1585,7 +2037,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the endpoint. */
                 endpoint_id: string;
             };
             cookie?: never;
@@ -1595,6 +2049,13 @@ interface operations {
             /** @description Deleted. */
             204: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content?: never;
@@ -1602,6 +2063,7 @@ interface operations {
             /** @description `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1611,6 +2073,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1620,6 +2083,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1629,6 +2093,20 @@ interface operations {
             /** @description No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1645,7 +2123,9 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the endpoint. */
                 endpoint_id: string;
             };
             cookie?: never;
@@ -1658,6 +2138,15 @@ 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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1667,6 +2156,7 @@ interface operations {
             /** @description Validation failure, or `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1676,6 +2166,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1685,6 +2176,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1694,15 +2186,19 @@ interface operations {
             /** @description No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "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;
                 };
                 content: {
@@ -1712,6 +2208,20 @@ interface operations {
             /** @description The new URL points at a private, loopback or internal address. */
             422: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1728,7 +2238,9 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the endpoint. */
                 endpoint_id: string;
             };
             cookie?: never;
@@ -1741,6 +2253,15 @@ 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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1750,6 +2271,7 @@ interface operations {
             /** @description `grace_hours` out of range, or `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1759,6 +2281,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1768,6 +2291,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1777,15 +2301,32 @@ interface operations {
             /** @description No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1802,7 +2343,9 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the endpoint. */
                 endpoint_id: string;
             };
             cookie?: never;
@@ -1816,6 +2359,15 @@ 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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1825,6 +2377,7 @@ interface operations {
             /** @description Unknown `event_type`, or `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1834,6 +2387,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1843,6 +2397,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1852,15 +2407,32 @@ interface operations {
             /** @description No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1874,6 +2446,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1882,6 +2455,13 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1891,6 +2471,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1900,6 +2481,20 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1915,17 +2510,20 @@ interface operations {
                 type?: ("job.succeeded" | "job.failed" | "credits.low")[];
                 /** @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;
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1934,6 +2532,13 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1943,6 +2548,7 @@ interface operations {
             /** @description Invalid filter value or cursor. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1952,6 +2558,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1961,6 +2568,20 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1974,6 +2595,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
                 /** @description The event id, `evt_<uuid>`. */
                 event_id: string;
@@ -1984,6 +2606,13 @@ interface operations {
         responses: {
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -1993,6 +2622,7 @@ interface operations {
             /** @description `event_id` is not `evt_<uuid>`. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2002,6 +2632,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2011,6 +2642,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2020,6 +2652,20 @@ interface operations {
             /** @description No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2039,6 +2685,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
                 /** @description The event id, `evt_<uuid>`. */
                 event_id: string;
@@ -2049,6 +2696,15 @@ 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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2058,6 +2714,7 @@ interface operations {
             /** @description `event_id` is not `evt_<uuid>`, or `endpoint_id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2067,6 +2724,7 @@ interface operations {
             /** @description Missing or invalid bearer token. */
             401: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2076,6 +2734,7 @@ interface operations {
             /** @description Caller lacks `trawl.webhook.read` (reads) or `trawl.webhook.manage` (changes, Send test, replay), or Trawl is not enabled for the workspace (`SERVICE_NOT_ENABLED`). */
             403: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2085,15 +2744,32 @@ interface operations {
             /** @description No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. Or No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`). */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
                     "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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2107,7 +2783,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2117,6 +2795,13 @@ interface operations {
             /** @description Webhook. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2126,6 +2811,7 @@ interface operations {
             /** @description `id` is not a UUID. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2135,6 +2821,20 @@ interface operations {
             /** @description Webhook not found. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2148,7 +2848,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2158,6 +2860,13 @@ interface operations {
             /** @description Deleted. */
             204: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content?: never;
@@ -2165,6 +2874,20 @@ interface operations {
             /** @description Webhook not found. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2178,7 +2901,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2192,6 +2917,13 @@ interface operations {
             /** @description Updated webhook (secret masked). */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2201,6 +2933,7 @@ interface operations {
             /** @description Invalid URL. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2210,6 +2943,20 @@ interface operations {
             /** @description Webhook not found. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2230,7 +2977,9 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2240,6 +2989,13 @@ interface operations {
             /** @description Page of delivery attempts with a pagination cursor. */
             200: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2249,6 +3005,7 @@ interface operations {
             /** @description Invalid cursor, limit or `status` filter. */
             400: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2258,6 +3015,20 @@ interface operations {
             /** @description Webhook not found in this workspace. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2271,7 +3042,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2281,6 +3054,13 @@ interface operations {
             /** @description Secret rotated. Includes the new plaintext secret exactly once. */
             201: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2290,6 +3070,20 @@ interface operations {
             /** @description Webhook not found. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2303,7 +3097,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
+                /** @description Id of the webhook. */
                 id: string;
             };
             cookie?: never;
@@ -2313,6 +3109,13 @@ interface operations {
             /** @description Sent. Read the outcome from `/deliveries`. */
             202: {
                 headers: {
+                    "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"];
+                    "X-RateLimit-Remaining-short": components["headers"]["X-RateLimit-Remaining-short"];
+                    "X-RateLimit-Reset-long": components["headers"]["X-RateLimit-Reset-long"];
+                    "X-RateLimit-Reset-short": components["headers"]["X-RateLimit-Reset-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2322,6 +3125,7 @@ interface operations {
             /** @description Webhook not found. */
             404: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {
@@ -2331,6 +3135,20 @@ interface operations {
             /** @description The webhook is switched off. */
             422: {
                 headers: {
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds. */
+            429: {
+                headers: {
+                    "Retry-After": components["headers"]["Retry-After"];
+                    "Retry-After-long": components["headers"]["Retry-After-long"];
+                    "Retry-After-short": components["headers"]["Retry-After-short"];
+                    "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
                 content: {