@productcraft/trawl 0.2.2 → 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
@@ -555,54 +564,100 @@ interface components {
             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: {
@@ -620,8 +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" | "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;
+        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.
@@ -644,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"][];
         };
@@ -707,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. */
@@ -718,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;
@@ -725,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;
@@ -763,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;
@@ -782,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.
@@ -818,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;
             /**
@@ -841,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;
@@ -864,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;
             /**
@@ -900,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;
@@ -928,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;
@@ -944,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;
@@ -960,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"][];
@@ -973,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"][];
@@ -1000,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;
@@ -1091,6 +1213,24 @@ interface components {
     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;
 }
@@ -1103,6 +1243,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1112,6 +1253,12 @@ 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;
                 };
@@ -1139,19 +1286,34 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     JobController_list: {
         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;
@@ -1161,6 +1323,12 @@ 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;
                 };
@@ -1178,6 +1346,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     JobController_create: {
@@ -1188,6 +1369,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1201,6 +1383,14 @@ 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;
                 };
@@ -1228,9 +1418,24 @@ interface operations {
                     "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;
                 };
@@ -1245,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;
@@ -1255,6 +1462,12 @@ 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;
                 };
@@ -1272,6 +1485,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     JobController_cancel: {
@@ -1279,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;
@@ -1289,6 +1517,12 @@ 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;
                 };
@@ -1316,13 +1550,26 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WorkspaceStatsController_get: {
         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: {
@@ -1336,6 +1583,12 @@ 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;
                 };
@@ -1373,6 +1626,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_list: {
@@ -1385,6 +1651,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1394,6 +1661,12 @@ 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;
                 };
@@ -1411,6 +1684,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_create: {
@@ -1421,6 +1707,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1434,6 +1721,14 @@ 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;
                 };
@@ -1451,9 +1746,24 @@ interface operations {
                     "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;
                 };
@@ -1468,6 +1778,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1476,6 +1787,12 @@ 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;
                 };
@@ -1513,6 +1830,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_createEndpoint: {
@@ -1523,6 +1853,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1535,6 +1866,14 @@ 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;
                 };
@@ -1572,9 +1911,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -1592,6 +1933,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_getEndpoint: {
@@ -1599,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;
@@ -1608,6 +1964,12 @@ 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;
                 };
@@ -1655,6 +2017,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_deleteEndpoint: {
@@ -1662,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;
@@ -1672,6 +2049,12 @@ 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;
                 };
@@ -1717,6 +2100,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_updateEndpoint: {
@@ -1727,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;
@@ -1740,6 +2138,14 @@ 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;
                 };
@@ -1787,9 +2193,11 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
                     "X-Request-Id": components["headers"]["RequestId"];
                     [name: string]: unknown;
                 };
@@ -1807,6 +2215,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_rotateSecret: {
@@ -1817,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;
@@ -1830,6 +2253,14 @@ 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;
                 };
@@ -1877,9 +2308,24 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                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;
                 };
@@ -1897,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;
@@ -1911,6 +2359,14 @@ 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;
                 };
@@ -1958,9 +2414,24 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                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;
                 };
@@ -1975,6 +2446,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1983,6 +2455,12 @@ 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;
                 };
@@ -2010,6 +2488,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_listEvents: {
@@ -2019,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;
@@ -2038,6 +2532,12 @@ 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;
                 };
@@ -2075,6 +2575,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_getEvent: {
@@ -2082,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;
@@ -2092,6 +2606,12 @@ 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;
                 };
@@ -2139,6 +2659,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhooksController_trawl_workspace_replay: {
@@ -2152,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;
@@ -2162,6 +2696,14 @@ 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;
                 };
@@ -2209,9 +2751,24 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description `endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). */
+            /** @description `endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key). */
             409: {
                 headers: {
+                    /** @description Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`). */
+                    "Retry-After"?: number;
+                    "X-Request-Id": components["headers"]["RequestId"];
+                    [name: string]: unknown;
+                };
+                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;
                 };
@@ -2226,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;
@@ -2236,6 +2795,12 @@ 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;
                 };
@@ -2263,6 +2828,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_remove: {
@@ -2270,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;
@@ -2280,6 +2860,12 @@ 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;
                 };
@@ -2295,6 +2881,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_update: {
@@ -2302,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;
@@ -2316,6 +2917,12 @@ 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;
                 };
@@ -2343,6 +2950,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_recentDeliveries: {
@@ -2357,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;
@@ -2367,6 +2989,12 @@ 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;
                 };
@@ -2394,6 +3022,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_rotateSecret: {
@@ -2401,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;
@@ -2411,6 +3054,12 @@ 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;
                 };
@@ -2428,6 +3077,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     WebhookController_fireTest: {
@@ -2435,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;
@@ -2445,6 +3109,12 @@ 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;
                 };
@@ -2472,6 +3142,19 @@ interface operations {
                     "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: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
 }