@productcraft/trawl 0.2.2 → 0.2.4

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
@@ -478,6 +487,64 @@ interface components {
              */
             reason: string;
         };
+        /**
+         * CreditsLowEvent
+         * @description Your Trawl balance dropped below 10% of your last top-up (at least 100 steps). Sent once; it comes again after your next top-up. New jobs are refused when the balance reaches zero. Job events also carry the keys of the previous webhook body (`event`, `occurred_at`, `job`) until its sunset; read `type`, `created_at` and `data` instead.
+         * @example {
+         *       "created_at": "2026-11-05T09:00:00.000Z",
+         *       "data": {
+         *         "balance_steps": 840,
+         *         "last_top_up_steps": 10000,
+         *         "threshold_steps": 1000
+         *       },
+         *       "id": "evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f",
+         *       "type": "credits.low",
+         *       "workspace_id": "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b"
+         *     }
+         */
+        CreditsLowEvent: {
+            /**
+             * Format: date-time
+             * @description When the event happened (the same on every retry).
+             * @example 2026-11-05T09:00:00.000Z
+             */
+            created_at: string;
+            data: components["schemas"]["CreditsLowEventDataDto"];
+            /**
+             * @description The event id, also sent as `webhook-id`; the same on every retry and replay.
+             * @example evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f
+             */
+            id: string;
+            /** @description Present and true only on a delivery made by "Send test"; its `data` is the catalogue example. */
+            test?: boolean;
+            /**
+             * @description The event type. Switch on it to narrow the event.
+             * @enum {string}
+             */
+            type: "credits.low";
+            /**
+             * Format: uuid
+             * @description The workspace the event belongs to, so you can route without opening `data`. Absent on "Send test" deliveries.
+             */
+            workspace_id?: string;
+        };
+        CreditsLowEventDataDto: {
+            /**
+             * @description The balance, in steps, when the event was sent.
+             * @example 840
+             */
+            balance_steps: number;
+            /**
+             * @description Steps added by the last top-up.
+             * @example 10000
+             */
+            last_top_up_steps: number;
+            /**
+             * @description The threshold it dropped below: 10% of the last top-up, at least 100 steps.
+             * @example 1000
+             */
+            threshold_steps: number;
+        };
         CreditsResponseDto: {
             /**
              * @description Remaining steps. One agent step uses one credit; new jobs are refused (402) at zero. Can dip slightly below zero, because a running job is always allowed to finish.
@@ -554,55 +621,226 @@ interface components {
              */
             status_code: number;
         };
+        JobEventDataDto: {
+            /** @description The job that finished. */
+            job: components["schemas"]["JobOutcomeDto"];
+        };
+        /**
+         * JobFailedEvent
+         * @description An extraction job stopped without a result: the page did not load, the agent ran out of steps or time, or the result did not match your schema. The reason is in data.job.error. Job events also carry the keys of the previous webhook body (`event`, `occurred_at`, `job`) until its sunset; read `type`, `created_at` and `data` instead.
+         * @example {
+         *       "created_at": "2026-11-05T09:00:00.000Z",
+         *       "data": {
+         *         "job": {
+         *           "error": "The job ran out of steps before it found the data.",
+         *           "id": "7c1e2a4b-5d3f-4e8a-9b6c-0d1e2f3a4b5c",
+         *           "result": null,
+         *           "status": "failed"
+         *         }
+         *       },
+         *       "id": "evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f",
+         *       "type": "job.failed",
+         *       "workspace_id": "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b"
+         *     }
+         */
+        JobFailedEvent: {
+            /**
+             * Format: date-time
+             * @description When the event happened (the same on every retry).
+             * @example 2026-11-05T09:00:00.000Z
+             */
+            created_at: string;
+            data: components["schemas"]["JobEventDataDto"];
+            /**
+             * @description The event id, also sent as `webhook-id`; the same on every retry and replay.
+             * @example evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f
+             */
+            id: string;
+            /** @description Present and true only on a delivery made by "Send test"; its `data` is the catalogue example. */
+            test?: boolean;
+            /**
+             * @description The event type. Switch on it to narrow the event.
+             * @enum {string}
+             */
+            type: "job.failed";
+            /**
+             * Format: uuid
+             * @description The workspace the event belongs to, so you can route without opening `data`. Absent on "Send test" deliveries.
+             */
+            workspace_id?: string;
+        };
         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"];
         };
+        JobOutcomeDto: {
+            /**
+             * @description Why the job stopped without a result; null when it succeeded.
+             * @example null
+             */
+            error: string | null;
+            /**
+             * Format: uuid
+             * @description The job id.
+             * @example 7c1e2a4b-5d3f-4e8a-9b6c-0d1e2f3a4b5c
+             */
+            id: string;
+            /**
+             * @description The extracted JSON, matching the JSON Schema the job was created with; null when the job failed.
+             * @example {
+             *       "price": null,
+             *       "title": "Example Domain"
+             *     }
+             */
+            result: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * @description `succeeded` on `job.succeeded`, `failed` on `job.failed`.
+             * @example succeeded
+             */
+            status: components["schemas"]["JobOutcomeStatus"];
+        };
+        /** @enum {string} */
+        JobOutcomeStatus: "succeeded" | "failed";
         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";
+        /**
+         * JobSucceededEvent
+         * @description An extraction job finished and its result matches your JSON Schema. The result is in data.job.result. Job events also carry the keys of the previous webhook body (`event`, `occurred_at`, `job`) until its sunset; read `type`, `created_at` and `data` instead.
+         * @example {
+         *       "created_at": "2026-11-05T09:00:00.000Z",
+         *       "data": {
+         *         "job": {
+         *           "error": null,
+         *           "id": "7c1e2a4b-5d3f-4e8a-9b6c-0d1e2f3a4b5c",
+         *           "result": {
+         *             "price": null,
+         *             "title": "Example Domain"
+         *           },
+         *           "status": "succeeded"
+         *         }
+         *       },
+         *       "id": "evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f",
+         *       "type": "job.succeeded",
+         *       "workspace_id": "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b"
+         *     }
+         */
+        JobSucceededEvent: {
+            /**
+             * Format: date-time
+             * @description When the event happened (the same on every retry).
+             * @example 2026-11-05T09:00:00.000Z
+             */
+            created_at: string;
+            data: components["schemas"]["JobEventDataDto"];
+            /**
+             * @description The event id, also sent as `webhook-id`; the same on every retry and replay.
+             * @example evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f
+             */
+            id: string;
+            /** @description Present and true only on a delivery made by "Send test"; its `data` is the catalogue example. */
+            test?: boolean;
+            /**
+             * @description The event type. Switch on it to narrow the event.
+             * @enum {string}
+             */
+            type: "job.succeeded";
+            /**
+             * Format: uuid
+             * @description The workspace the event belongs to, so you can route without opening `data`. Absent on "Send test" deliveries.
+             */
+            workspace_id?: string;
+        };
         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 +858,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 +886,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 +949,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 +959,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 +967,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 +1008,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 +1046,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 +1079,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 +1113,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 +1139,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 +1187,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 +1218,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 +1235,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 +1258,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 +1274,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 +1301,43 @@ 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";
+        /**
+         * @description Every event type this product sends; `x-webhooks` maps each to its payload schema. New types can be added, so treat it as open.
+         * @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 +1399,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 +1429,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1112,6 +1439,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 +1472,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 +1509,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 +1532,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 +1555,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1201,6 +1569,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 +1604,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 +1636,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 +1648,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 +1671,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 +1691,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 +1703,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 +1736,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 +1769,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 +1812,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 +1837,7 @@ interface operations {
             };
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1394,6 +1847,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 +1870,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 +1893,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1434,6 +1907,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 +1932,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 +1964,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1476,6 +1973,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 +2016,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 +2039,7 @@ interface operations {
                 "Idempotency-Key"?: string;
             };
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1535,6 +2052,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 +2097,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 +2119,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 +2139,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 +2150,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 +2203,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 +2223,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 +2235,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 +2286,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 +2309,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 +2324,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 +2379,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 +2401,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 +2424,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 +2439,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 +2494,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 +2529,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 +2545,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 +2600,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 +2632,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Id of the workspace. */
                 workspace_id: string;
             };
             cookie?: never;
@@ -1983,6 +2641,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 +2674,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 +2696,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 +2718,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 +2761,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 +2781,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 +2792,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 +2845,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 +2871,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 +2882,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 +2937,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 +2969,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 +2981,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 +3014,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 +3034,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 +3046,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 +3067,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 +3087,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 +3103,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 +3136,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 +3163,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 +3175,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 +3208,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 +3228,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 +3240,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 +3263,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 +3283,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 +3295,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 +3328,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"];
+                };
+            };
         };
     };
 }