@nohead/sdk 0.6.0 → 0.8.0

package/dist/generated/types.gen.d.ts

@@ -174,7 +174,7 @@ export type TextFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -205,7 +205,7 @@ export type LongTextFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -225,7 +225,7 @@ export type RichTextFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -243,7 +243,7 @@ export type IntegerFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -267,7 +267,7 @@ export type DecimalFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -287,7 +287,7 @@ export type DateFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -313,7 +313,7 @@ export type BooleanFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -331,7 +331,7 @@ export type EnumFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -350,7 +350,7 @@ export type AssetFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -372,7 +372,7 @@ export type RelationFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -394,7 +394,7 @@ export type JsonFieldConfiguration = {
      */
     description?: string;
     /**
-     * Search words match the field (API searches). Default true for text, long_text, rich_text and enum.
+     * Search words match the field, in every search (API keys, search tokens, members). Default true for text, long_text, rich_text and enum.
      */
     searchable?: boolean;
     /**
@@ -539,7 +539,7 @@ export type FieldCreateProperties = {
     multiple?: boolean;
 };
 /**
- * Renames, describes or loosens a field. A change to its `type` or `multiple` rewrites record values, so it is a field migration (`POST /v1/fields/{id}/migrations`); either key here is `400` `unknown_parameter`, saying so.
+ * Renames, describes or loosens a field. A change to its `type` or `multiple` rewrites record values, so it is a field migration (`POST /v1/collections/{collection_id}/migrations`); either key here is `400` `unknown_parameter`, saying so.
  */
 export type FieldUpdate = {
     name?: string;
@@ -1480,6 +1480,7 @@ export type WebhookTestEventData = {
     webhook: null | Webhook;
 };
 export type Asset = AssetProperties;
+export type AssetKind = 'image' | 'video' | 'audio' | 'document' | 'other';
 export type AssetUpdate = {
     /**
      * Control characters are removed and path separators become `_`, as on upload.
@@ -1535,9 +1536,25 @@ export type AssetProperties = {
      */
     image_url: string | null;
     /**
-     * The URL of a small rendition (fits in 640×640, WebP), for ready images, deleted ones included until they are purged; null otherwise.
+     * The URL of a small rendition (fits in 640×640, WebP), for ready images and SVGs (rasterized; SVGs have no `image_url`), deleted ones included until they are purged; null otherwise.
      */
     preview_url: string | null;
+    /**
+     * The URL of the file as uploaded, for ready assets of any type,
+     * deleted ones included until they are purged; null otherwise. It
+     * downloads the file under its `filename` (a rename applies within a
+     * minute or so), is open and never expires, and is cached on a CDN.
+     *
+     */
+    file_url: string | null;
+    /**
+     * The URL that plays a ready video or audio file inline, for
+     * `<video>` and `<audio>` (with range requests, so players can seek),
+     * deleted ones included until they are purged; null for other types.
+     * Open, never expiring and cached on a CDN, like `file_url`.
+     *
+     */
+    media_url: string | null;
     uploaded_at: NullableTimestamp;
     created_at: Timestamp;
     updated_at: Timestamp;
@@ -1568,17 +1585,11 @@ export type AssetUsage = {
         fields: Array<string>;
     }>;
 };
-export type DownloadUrl = {
-    object: 'download_url';
-    asset_id: string;
-    url: string;
-    expires_at: Timestamp;
-};
 export type AssetUploadCreate = {
     filename: string;
     content_type: string;
     /**
-     * Exact size of the file in bytes (at most 100 MB by default).
+     * Exact size of the file in bytes, at most the plan's largest upload (10 MB on Free, 100 MB on paid plans).
      */
     byte_size: number;
 };
@@ -1762,10 +1773,22 @@ export type DeletedFilter = {
  * `type*` wildcard, or several with
  * `filter[content_type][in]=image*,application/pdf`, for example the
  * ones an asset field accepts (its `accepted_types`).
+ * `filter[kind]` lists only assets of a kind, or several with
+ * `filter[kind][in]=image,video`: `image`, `video` and `audio` by
+ * their types (`image*` and so on); `document` for PDFs, plain text,
+ * Markdown, CSV, and word processing, spreadsheet and presentation
+ * files (Microsoft Office, OpenDocument, RTF); `other` for every other
+ * file.
  *
  */
 export type AssetFilter = {
     deleted?: 'true' | 'false';
+    kind?: AssetKind | {
+        /**
+         * Comma-separated kinds.
+         */
+        in: string;
+    };
     content_type?: string | {
         /**
          * Up to 50 comma-separated MIME types or `type*` wildcards.
@@ -1884,7 +1907,10 @@ export type RecordsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -1979,7 +2005,10 @@ export type RecordsCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2065,7 +2094,10 @@ export type RecordsDeleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2112,7 +2144,10 @@ export type RecordsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2198,7 +2233,10 @@ export type RecordsUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2274,7 +2312,10 @@ export type RecordsCountErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2353,7 +2394,10 @@ export type RecordsBulkErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2441,7 +2485,10 @@ export type RecordsRestoreErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2523,7 +2570,10 @@ export type RecordsUnpublishErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2565,7 +2615,10 @@ export type RecordsGetPublicationErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2647,7 +2700,10 @@ export type RecordsPublishErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2709,7 +2765,10 @@ export type RecordsUnscheduleErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2751,7 +2810,10 @@ export type RecordsGetScheduleErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2817,7 +2879,10 @@ export type RecordsScheduleErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2872,7 +2937,10 @@ export type ScheduledChangesListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2934,7 +3002,10 @@ export type RecordRevisionsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -2980,7 +3051,10 @@ export type RecordRevisionsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3022,7 +3096,10 @@ export type RevisionsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3114,7 +3191,10 @@ export type RecordRevisionsRevertErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3159,7 +3239,10 @@ export type RecordsDiffErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3210,7 +3293,10 @@ export type RecordDraftsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3276,7 +3362,10 @@ export type DraftsCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3331,7 +3420,10 @@ export type DraftsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3403,7 +3495,10 @@ export type DraftsDiscardErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3450,7 +3545,10 @@ export type DraftsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3526,7 +3624,10 @@ export type DraftsUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3612,7 +3713,10 @@ export type DraftsMergeErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3674,7 +3778,10 @@ export type DraftsUnscheduleErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3740,7 +3847,10 @@ export type DraftsScheduleErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3797,7 +3907,10 @@ export type CollectionsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3879,7 +3992,10 @@ export type CollectionsCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3954,7 +4070,10 @@ export type CollectionsDeleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -3999,7 +4118,10 @@ export type CollectionsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4078,7 +4200,10 @@ export type CollectionsUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4163,7 +4288,10 @@ export type CollectionsRestoreErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4213,7 +4341,10 @@ export type CollectionsGetSchemaErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4267,7 +4398,10 @@ export type SchemaChangesListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4309,7 +4443,10 @@ export type SchemaChangesGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4369,7 +4506,10 @@ export type FieldsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4448,7 +4588,10 @@ export type FieldsCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4520,7 +4663,10 @@ export type FieldsDeleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4562,7 +4708,10 @@ export type FieldsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4638,7 +4787,10 @@ export type FieldsUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4683,7 +4835,10 @@ export type FieldsGetOrderErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4764,7 +4919,10 @@ export type FieldsReorderErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4830,7 +4988,10 @@ export type FieldsRemoveAliasErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4906,7 +5067,10 @@ export type FieldsRestoreErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -4960,7 +5124,10 @@ export type MigrationsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5041,7 +5208,10 @@ export type MigrationsCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5087,7 +5257,10 @@ export type MigrationsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5149,7 +5322,10 @@ export type MigrationsCancelErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5168,6 +5344,13 @@ export type AssetsListData = {
         project_id: string;
     };
     query?: {
+        /**
+         * Words that must each appear in the filename or the alt text,
+         * ignoring case: `q=hero jpg` finds `Hero-banner.jpg`. Up to 10
+         * words and 200 characters (`400` beyond).
+         *
+         */
+        q?: string;
         /**
          * Page size.
          */
@@ -5182,10 +5365,22 @@ export type AssetsListData = {
          * `type*` wildcard, or several with
          * `filter[content_type][in]=image*,application/pdf`, for example the
          * ones an asset field accepts (its `accepted_types`).
+         * `filter[kind]` lists only assets of a kind, or several with
+         * `filter[kind][in]=image,video`: `image`, `video` and `audio` by
+         * their types (`image*` and so on); `document` for PDFs, plain text,
+         * Markdown, CSV, and word processing, spreadsheet and presentation
+         * files (Microsoft Office, OpenDocument, RTF); `other` for every other
+         * file.
          *
          */
         filter?: {
             deleted?: 'true' | 'false';
+            kind?: AssetKind | {
+                /**
+                 * Comma-separated kinds.
+                 */
+                in: string;
+            };
             content_type?: string | {
                 /**
                  * Up to 50 comma-separated MIME types or `type*` wildcards.
@@ -5217,7 +5412,10 @@ export type AssetsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5289,7 +5487,10 @@ export type AssetsUploadErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5355,7 +5556,10 @@ export type AssetsCompleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5417,7 +5621,10 @@ export type AssetsDeleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5459,7 +5666,10 @@ export type AssetsGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5525,7 +5735,10 @@ export type AssetsUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5538,52 +5751,6 @@ export type AssetsUpdateResponses = {
     200: Asset;
 };
 export type AssetsUpdateResponse = AssetsUpdateResponses[keyof AssetsUpdateResponses];
-export type AssetsDownloadUrlData = {
-    body?: never;
-    path: {
-        asset_id: string;
-    };
-    query?: never;
-    url: '/v1/assets/{asset_id}/download-url';
-};
-export type AssetsDownloadUrlErrors = {
-    /**
-     * The request was malformed: unparseable JSON, an invalid query parameter, or a body key the operation doesn't take (detail code `unknown_parameter`, naming the key).
-     */
-    400: Error;
-    /**
-     * Authentication is missing or invalid.
-     */
-    401: Error;
-    /**
-     * The caller is not allowed to perform this action.
-     */
-    403: Error;
-    /**
-     * The resource does not exist or is not visible to the caller.
-     */
-    404: Error;
-    /**
-     * The request conflicts with current state.
-     */
-    409: Error;
-    /**
-     * Too many requests for this API key or user (or, with failing
-     * credentials, this IP address). A published-only key is counted per
-     * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
-     *
-     */
-    429: Error;
-};
-export type AssetsDownloadUrlError = AssetsDownloadUrlErrors[keyof AssetsDownloadUrlErrors];
-export type AssetsDownloadUrlResponses = {
-    /**
-     * The download URL.
-     */
-    200: DownloadUrl;
-};
-export type AssetsDownloadUrlResponse = AssetsDownloadUrlResponses[keyof AssetsDownloadUrlResponses];
 export type AssetsUsageData = {
     body?: never;
     path: {
@@ -5613,7 +5780,10 @@ export type AssetsUsageErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5675,7 +5845,10 @@ export type AssetsRestoreErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5737,7 +5910,10 @@ export type AssetsPurgeErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5834,7 +6010,10 @@ export type CollectionsSearchErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5906,7 +6085,10 @@ export type ProjectsSearchErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -5955,7 +6137,10 @@ export type SearchIndexGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6020,7 +6205,10 @@ export type SearchIndexRebuildErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6077,7 +6265,10 @@ export type WebhooksListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6149,7 +6340,10 @@ export type WebhooksCreateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6211,7 +6405,10 @@ export type WebhooksDeleteErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6253,7 +6450,10 @@ export type WebhooksGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6319,7 +6519,10 @@ export type WebhooksUpdateErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6381,7 +6584,10 @@ export type WebhooksTestErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6432,7 +6638,10 @@ export type WebhookSecretsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6494,7 +6703,10 @@ export type WebhooksRotateSecretErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6556,7 +6768,10 @@ export type WebhookSecretsRetireErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6624,7 +6839,10 @@ export type WebhooksRestoreErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6678,7 +6896,10 @@ export type WebhookDeliveriesListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6720,7 +6941,10 @@ export type WebhookDeliveriesGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6782,7 +7006,10 @@ export type WebhookDeliveriesRetryErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6857,7 +7084,10 @@ export type AuditEventsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6905,7 +7135,10 @@ export type MeGetErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;
@@ -6941,7 +7174,10 @@ export type FeatureFlagsListErrors = {
      * Too many requests for this API key or user (or, with failing
      * credentials, this IP address). A published-only key is counted per
      * client IP. Wait `Retry-After` seconds; retries with the same `Idempotency-Key`
-     * are safe.
+     * are safe. On the Free plan, an organization's API keys are also
+     * refused once its API requests reach the month's limit, with a
+     * `plan_limit` detail (`field` `api_requests`, `usage` and `limit`),
+     * until the next month (UTC) or an upgrade.
      *
      */
     429: Error;