@nohead/sdk 0.5.0 → 0.7.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;
@@ -574,11 +574,15 @@ export type Collection = {
      */
     purge_after: NullableTimestamp;
     /**
-     * Whether API keys can search the collection (`GET /v1/collections/{collection_id}/search`).
-     * Every collection is indexed; members can search it in the web app either way.
+     * Whether the project's search tokens (made in the web app) find
+     * its published records, from a browser or a backend. Off by
+     * default: every field of those records becomes readable by anyone
+     * with a token, so turn it on only for collections whose published
+     * records are public. A change reaches search tokens within
+     * seconds.
      *
      */
-    search_enabled: boolean;
+    public_search: boolean;
     /**
      * Active fields in position order.
      */
@@ -587,17 +591,17 @@ export type Collection = {
     updated_at: Timestamp;
 };
 export type CollectionCreate = {
-    search_enabled?: boolean;
     name: string;
     slug: string;
     description?: string | null;
+    public_search?: boolean;
     fields?: Array<FieldCreate>;
 };
 export type CollectionUpdate = {
-    search_enabled?: boolean;
     name?: string;
     slug?: string;
     description?: string | null;
+    public_search?: boolean;
 };
 export type CollectionList = {
     data: Array<Collection>;
@@ -612,7 +616,10 @@ export type SchemaDefinition = {
     slug: string;
     description: string | null;
     deleted_at: NullableTimestamp;
-    search_enabled?: boolean;
+    /**
+     * Absent from schemas before the setting existed (off).
+     */
+    public_search?: boolean;
     fields: Array<{
         id: string;
         name: string;
@@ -876,7 +883,7 @@ export type TimeFilter = {
 /**
  * The client a change came through; `scheduler` for scheduled changes.
  */
-export type Via = 'ui' | 'api' | 'cli' | 'sdk' | 'system' | 'scheduler';
+export type Via = 'ui' | 'api' | 'cli' | 'sdk' | 'mcp' | 'system' | 'scheduler';
 /**
  * Changes to a record's content that wait until they are merged into
  * it, now or at `schedule.merge_at`. Content only: whether the record
@@ -1022,6 +1029,16 @@ export type Record = {
 export type RecordWrite = {
     data: RecordData;
 };
+export type RecordCreate = {
+    data: RecordData;
+    /**
+     * The key of a `unique` field (a slug, or a field with `unique` on)
+     * whose value `data` includes: update the record that has it, or
+     * create one.
+     *
+     */
+    upsert_on?: string;
+};
 export type RecordList = {
     data: Array<Record>;
     meta: ListMeta;
@@ -1140,9 +1157,11 @@ export type SearchIndex = {
     object: 'search_index';
     collection_id: string;
     /**
-     * The collection's `search_enabled`; the index is kept up to date either way.
+     * The index's name in the search engine, which search tokens search
+     * (`indexUid` in Meilisearch's search API). Opaque; it never changes.
+     *
      */
-    enabled: boolean;
+    index: string;
     /**
      * `building` until first built; `stale` from the change that queues a rebuild until it has run; `failed` if the last rebuild failed (it is retried).
      */
@@ -1157,7 +1176,7 @@ export type SearchIndex = {
  * (`record.*`, `draft.*`, `collection.*`, `field.*`, `asset.*`) or `*` for all.
  *
  */
-export type WebhookEventType = 'record.created' | 'record.updated' | 'record.published' | 'record.unpublished' | 'record.deleted' | 'record.restored' | 'record.reverted' | 'record.redacted' | 'record.scheduled' | 'record.unscheduled' | 'record.schedule_failed' | 'draft.created' | 'draft.updated' | 'draft.discarded' | 'draft.scheduled' | 'draft.unscheduled' | 'draft.schedule_failed' | 'collection.created' | 'collection.updated' | 'collection.deleted' | 'collection.restored' | 'collection.fields_reordered' | 'field.created' | 'field.updated' | 'field.deleted' | 'field.restored' | 'field.migrated' | 'field.alias_removed' | 'asset.created' | 'asset.deleted' | 'asset.restored' | 'asset.purged';
+export type WebhookEventType = 'record.created' | 'record.updated' | 'record.published' | 'record.unpublished' | 'record.deleted' | 'record.restored' | 'record.reverted' | 'record.redacted' | 'record.scheduled' | 'record.unscheduled' | 'record.schedule_failed' | 'draft.created' | 'draft.updated' | 'draft.discarded' | 'draft.scheduled' | 'draft.unscheduled' | 'draft.schedule_failed' | 'collection.created' | 'collection.updated' | 'collection.deleted' | 'collection.restored' | 'collection.fields_reordered' | 'field.created' | 'field.updated' | 'field.deleted' | 'field.restored' | 'field.migrated' | 'field.alias_removed' | 'asset.created' | 'asset.updated' | 'asset.deleted' | 'asset.restored' | 'asset.purged';
 export type WebhookSubscription = WebhookEventType | 'record.*' | 'draft.*' | 'collection.*' | 'field.*' | 'asset.*' | '*';
 export type Webhook = WebhookProperties;
 export type WebhookProperties = {
@@ -1461,14 +1480,29 @@ 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.
+     */
+    filename?: string;
+    /**
+     * Surrounding whitespace is removed; empty or null clears it.
+     */
+    alt?: string | null;
+};
 export type AssetProperties = {
     id: string;
     object: 'asset';
     project_id: string;
     /**
-     * The original filename, any Unicode.
+     * The filename, any Unicode, as uploaded unless renamed since. Downloads use it.
      */
     filename: string;
+    /**
+     * Alternative text, saying what an image shows; null until set. The default wherever the asset is used.
+     */
+    alt: string | null;
     content_type: string;
     byte_size: number;
     /**
@@ -1489,7 +1523,20 @@ export type AssetProperties = {
      */
     purge_after: NullableTimestamp;
     /**
-     * A signed 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 the whole image, for ready images (JPEG, PNG, GIF, WebP
+     * or AVIF), deleted ones included until they are purged; null
+     * otherwise. Image URLs are open and never expire. For a rendition,
+     * write [imgproxy processing options](https://docs.imgproxy.net/usage/processing)
+     * before `/plain/`, and a format after `@`: for example
+     * `https://images.nohead.io/rs:fill:800:600/g:sm/plain/…@webp`. Renditions
+     * are at most 4096 pixels a side, from originals of at most 50
+     * megapixels. Options that would return the file as stored (`raw`,
+     * `skip_processing`, `strip_metadata`) are refused.
+     *
+     */
+    image_url: string | null;
+    /**
+     * 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;
     uploaded_at: NullableTimestamp;
@@ -1500,16 +1547,6 @@ export type AssetList = {
     data: Array<Asset>;
     meta: ListMeta;
 };
-export type ImageUrl = {
-    object: 'image_url';
-    asset_id: string;
-    url: string;
-    width: number | null;
-    height: number | null;
-    fit: 'contain' | 'cover' | 'fill';
-    format: 'original' | 'webp' | 'avif' | 'jpeg' | 'png';
-    quality: number | null;
-};
 export type AssetUsage = {
     object: 'asset_usage';
     asset_id: string;
@@ -1632,6 +1669,7 @@ export type WebhookId = string;
 export type DeliveryId = string;
 export type RecordId = string;
 export type DraftId = string;
+export type RevisionId = string;
 /**
  * Per-record revision number.
  */
@@ -1725,10 +1763,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.
@@ -1847,7 +1897,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;
@@ -1861,7 +1914,7 @@ export type RecordsListResponses = {
 };
 export type RecordsListResponse = RecordsListResponses[keyof RecordsListResponses];
 export type RecordsCreateData = {
-    body: RecordWrite;
+    body: RecordCreate;
     headers?: {
         /**
          * A unique value (1-255 printable ASCII characters) that makes retrying
@@ -1873,6 +1926,10 @@ export type RecordsCreateData = {
          *
          */
         'Idempotency-Key'?: string;
+        /**
+         * The revision you last read (the record's, or the draft's for a draft), e.g. `"7"`. Stale writes fail with 412.
+         */
+        'If-Match'?: string;
         /**
          * First-party client identifier recorded in history (e.g. `cli/0.3.1`). Informational only.
          */
@@ -1924,6 +1981,12 @@ export type RecordsCreateErrors = {
      * The request conflicts with current state.
      */
     409: Error;
+    /**
+     * The resource changed since the revision given in `If-Match`. Nothing was
+     * written; `details` includes the current revision.
+     *
+     */
+    412: Error;
     /**
      * The request failed validation.
      */
@@ -1932,13 +1995,20 @@ 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;
 };
 export type RecordsCreateError = RecordsCreateErrors[keyof RecordsCreateErrors];
 export type RecordsCreateResponses = {
+    /**
+     * The record.
+     */
+    200: Record;
     /**
      * The created record.
      */
@@ -2014,7 +2084,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;
@@ -2061,7 +2134,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;
@@ -2147,7 +2223,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;
@@ -2223,7 +2302,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;
@@ -2302,7 +2384,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;
@@ -2390,7 +2475,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;
@@ -2472,7 +2560,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;
@@ -2514,7 +2605,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;
@@ -2596,7 +2690,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;
@@ -2658,7 +2755,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;
@@ -2700,7 +2800,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;
@@ -2766,7 +2869,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;
@@ -2821,7 +2927,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;
@@ -2883,7 +2992,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;
@@ -2929,7 +3041,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;
@@ -2942,6 +3057,51 @@ export type RecordRevisionsGetResponses = {
     200: RecordRevisionDetail;
 };
 export type RecordRevisionsGetResponse = RecordRevisionsGetResponses[keyof RecordRevisionsGetResponses];
+export type RevisionsGetData = {
+    body?: never;
+    path: {
+        revision_id: string;
+    };
+    query?: never;
+    url: '/v1/revisions/{revision_id}';
+};
+export type RevisionsGetErrors = {
+    /**
+     * 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;
+    /**
+     * 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. 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;
+};
+export type RevisionsGetError = RevisionsGetErrors[keyof RevisionsGetErrors];
+export type RevisionsGetResponses = {
+    /**
+     * The revision with its snapshot and changes.
+     */
+    200: RecordRevisionDetail;
+};
+export type RevisionsGetResponse = RevisionsGetResponses[keyof RevisionsGetResponses];
 export type RecordRevisionsRevertData = {
     body?: never;
     headers?: {
@@ -3021,7 +3181,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;
@@ -3066,7 +3229,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;
@@ -3117,7 +3283,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;
@@ -3183,7 +3352,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;
@@ -3238,7 +3410,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;
@@ -3310,7 +3485,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;
@@ -3357,7 +3535,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;
@@ -3433,7 +3614,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;
@@ -3519,7 +3703,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;
@@ -3581,7 +3768,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;
@@ -3647,7 +3837,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;
@@ -3704,7 +3897,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;
@@ -3786,7 +3982,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;
@@ -3861,7 +4060,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;
@@ -3906,7 +4108,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;
@@ -3985,7 +4190,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;
@@ -4070,7 +4278,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;
@@ -4120,7 +4331,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;
@@ -4174,7 +4388,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;
@@ -4216,7 +4433,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;
@@ -4276,7 +4496,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;
@@ -4355,7 +4578,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;
@@ -4427,7 +4653,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;
@@ -4469,7 +4698,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;
@@ -4545,7 +4777,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;
@@ -4590,7 +4825,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;
@@ -4671,7 +4909,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;
@@ -4737,7 +4978,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;
@@ -4813,7 +5057,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;
@@ -4867,7 +5114,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;
@@ -4948,7 +5198,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;
@@ -4994,7 +5247,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;
@@ -5056,7 +5312,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;
@@ -5075,6 +5334,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.
          */
@@ -5089,10 +5355,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.
@@ -5124,7 +5402,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;
@@ -5196,7 +5477,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;
@@ -5262,7 +5546,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;
@@ -5324,7 +5611,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;
@@ -5366,7 +5656,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;
@@ -5379,24 +5672,31 @@ export type AssetsGetResponses = {
     200: Asset;
 };
 export type AssetsGetResponse = AssetsGetResponses[keyof AssetsGetResponses];
-export type AssetsImageUrlData = {
-    body?: never;
-    path: {
-        asset_id: string;
-    };
-    query?: {
-        width?: number;
-        height?: number;
+export type AssetsUpdateData = {
+    body: AssetUpdate;
+    headers?: {
+        /**
+         * A unique value (1-255 printable ASCII characters) that makes retrying
+         * this request safe. The first response (below 500) is stored for 24
+         * hours per user or API key; retries with the same key and the same
+         * request get it again with an `Idempotent-Replayed: true` header. The
+         * same key with a different request is refused with `400`; a retry while
+         * the first request is still running gets `409`.
+         *
+         */
+        'Idempotency-Key'?: string;
         /**
-         * `contain` fits inside width × height; `cover` fills it, cropping; `fill` stretches to it.
+         * First-party client identifier recorded in history (e.g. `cli/0.3.1`). Informational only.
          */
-        fit?: 'contain' | 'cover' | 'fill';
-        format?: 'original' | 'webp' | 'avif' | 'jpeg' | 'png';
-        quality?: number;
+        'Nohead-Client'?: string;
     };
-    url: '/v1/assets/{asset_id}/image-url';
+    path: {
+        asset_id: string;
+    };
+    query?: never;
+    url: '/v1/assets/{asset_id}';
 };
-export type AssetsImageUrlErrors = {
+export type AssetsUpdateErrors = {
     /**
      * 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).
      */
@@ -5425,23 +5725,22 @@ export type AssetsImageUrlErrors = {
      * 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;
-    /**
-     * The service is temporarily unavailable.
-     */
-    503: Error;
 };
-export type AssetsImageUrlError = AssetsImageUrlErrors[keyof AssetsImageUrlErrors];
-export type AssetsImageUrlResponses = {
+export type AssetsUpdateError = AssetsUpdateErrors[keyof AssetsUpdateErrors];
+export type AssetsUpdateResponses = {
     /**
-     * The image URL.
+     * The asset.
      */
-    200: ImageUrl;
+    200: Asset;
 };
-export type AssetsImageUrlResponse = AssetsImageUrlResponses[keyof AssetsImageUrlResponses];
+export type AssetsUpdateResponse = AssetsUpdateResponses[keyof AssetsUpdateResponses];
 export type AssetsDownloadUrlData = {
     body?: never;
     path: {
@@ -5475,7 +5774,10 @@ export type AssetsDownloadUrlErrors = {
      * 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;
@@ -5517,7 +5819,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;
@@ -5579,7 +5884,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;
@@ -5641,7 +5949,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;
@@ -5738,7 +6049,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;
@@ -5810,7 +6124,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;
@@ -5859,7 +6176,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;
@@ -5924,7 +6244,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;
@@ -5981,7 +6304,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;
@@ -6053,7 +6379,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;
@@ -6115,7 +6444,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;
@@ -6157,7 +6489,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;
@@ -6223,7 +6558,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;
@@ -6285,7 +6623,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;
@@ -6336,7 +6677,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;
@@ -6398,7 +6742,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;
@@ -6460,7 +6807,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;
@@ -6528,7 +6878,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;
@@ -6582,7 +6935,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;
@@ -6624,7 +6980,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;
@@ -6686,7 +7045,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;
@@ -6761,7 +7123,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;
@@ -6809,7 +7174,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;
@@ -6845,7 +7213,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;