@datocms/cma-client 5.2.0-alpha.3 → 5.2.0-alpha.5

package/src/generated/ApiTypes.ts

@@ -117,15 +117,15 @@ export type EnvironmentIdentity = string;
  */
 export type BuildTriggerIdentity = string;
 /**
- * ID of site_search_source
+ * ID of search_index
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "identity".
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "id".
  */
-export type SiteSearchSourceIdentity = string;
+export type SearchIndexIdentity = string;
 /**
  * This interface was referenced by `Role`'s JSON-Schema
  * via the `instances.targetSchema` link.
@@ -856,36 +856,35 @@ export type BuildEventInstancesHrefSchema = {
   [k: string]: unknown;
 };
 /**
- * ID of site search source event
+ * ID of search index event
  *
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "identity".
  *
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "id".
  */
-export type SiteSearchSourceEventIdentity = string;
+export type SearchIndexEventIdentity = string;
 /**
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "type".
  */
-export type SiteSearchSourceEventType = 'site_search_source_event';
+export type SearchIndexEventType = 'search_index_event';
 /**
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "type".
  */
-export type SiteSearchSourceType = 'site_search_source';
+export type SearchIndexType = 'search_index';
 /**
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `instances.targetSchema` link.
  */
-export type SiteSearchSourceEventInstancesTargetSchema =
-  SiteSearchSourceEvent[];
+export type SearchIndexEventInstancesTargetSchema = SearchIndexEvent[];
 /**
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `instances.hrefSchema` link.
  */
-export type SiteSearchSourceEventInstancesHrefSchema = {
+export type SearchIndexEventInstancesHrefSchema = {
   /**
    * Parameters to control offset-based pagination
    */
@@ -908,7 +907,7 @@ export type SiteSearchSourceEventInstancesHrefSchema = {
      */
     ids?: string;
     fields?: {
-      site_search_source_id?: {
+      search_index_id?: {
         eq?: string;
       };
       event_type?: {
@@ -931,8 +930,8 @@ export type SiteSearchSourceEventInstancesHrefSchema = {
    * Fields used to order results
    */
   order_by?:
-    | 'site_search_source_id_asc'
-    | 'site_search_source_id_desc'
+    | 'search_index_id_asc'
+    | 'search_index_id_desc'
     | 'created_at_asc'
     | 'created_at_desc'
     | 'event_type_asc'
@@ -963,19 +962,19 @@ export type ItemInstancesHrefSchema<
    */
   filter?: {
     /**
-     * Record (or block record) IDs to fetch, comma separated. If you use this filter, you _must not_ use `filter[type]` or `filter[fields]`
+     * Record (or block record) IDs to fetch, comma separated. If you use this filter, you _must not_ use `filter[type]`. You can combine it with meta fields (like `_published_at`, `_status`), but _must not_ use model-specific fields
      */
     ids?: string;
     /**
-     * Model ID or `api_key` to filter. If you use this filter, you _must not_ use `filter[ids]`. Comma separated values are accepted, but you _must not_ use `filter[fields]` in this case
+     * Model/Block model ID or `api_key` to filter. If you use this filter, you _must not_ use `filter[ids]`. When passing a single element, you can use both meta fields and model-specific fields (note: model-specific fields only work with models, not block models). When passing multiple comma-separated values, you can use meta fields but _must not_ use model-specific fields
      */
     type?: string;
     /**
-     * Textual query to match. You _must not_ use `filter[ids]`. If `locale` is defined, search within that locale. Otherwise environment's main locale will be used.
+     * Textual query to match. Can be combined with other filters. When used, only records (not blocks) are returned. If `locale` is defined, search within that locale. Otherwise environment's main locale will be used.
      */
     query?: string;
     /**
-     * Same as [GraphQL API records filters](/docs/content-delivery-api/filtering-records): you must use square brackets to indicate nesting levels. E.g. if you wanna [filter by parent record](/docs/content-delivery-api/filtering-records#parent) in a tree of records, you must use `filter[fields][parent][eq]=<ID_VALUE>`. Use snake_case for fields names. If `locale` is defined, search within that locale. Otherwise environment's main locale will be used.
+     * Filter by record fields. Meta fields (like `_published_at`, `_status`) can be used in most cases. Model-specific fields (like `title`, `name`) require `filter[type]` to specify a single model, and only work with models (not block models). Same syntax as [GraphQL API records filters](/docs/content-delivery-api/filtering-records): use square brackets to indicate nesting levels. E.g. `filter[fields][parent][eq]=<ID_VALUE>`. Use snake_case for field names. If `locale` is defined, search within that locale. Otherwise environment's main locale will be used.
      */
     fields?: ToItemHrefSchemaField<D>;
     /**
@@ -1044,7 +1043,7 @@ export type ItemSelfHrefSchema = {
    */
   nested?: boolean;
   /**
-   * Whether you want the currently published versions (`published`, default) of your records, or the latest available (`current`)
+   * Whether you want the currently published versions (`published`) of your records, or the latest available (`current`, default)
    */
   version?: string;
   [k: string]: unknown;
@@ -1422,11 +1421,11 @@ export type SearchResultInstancesHrefSchema = {
      */
     query: string;
     /**
-     * The site search source ID or name on which the search will be performed. If not provided, the first enabled site search source will be used.
+     * The search index ID on which the search will be performed. If not provided, the first enabled search index will be used.
      */
-    site_search_source_id?: string;
+    search_index_id?: string;
     /**
-     * **[Deprecated]** Use `site_search_source_id` instead. The build trigger ID or name on which the search will be performed. This parameter is only supported for backward compatibility and will return an error if the build trigger has multiple site search sources associated.
+     * The build trigger ID or name on which the search will be performed.
      */
     build_trigger_id?: string;
     /**
@@ -1643,10 +1642,10 @@ export type WebhookCallInstancesHrefSchema = {
  */
 export type BuildTriggerInstancesTargetSchema = BuildTrigger[];
 /**
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `instances.targetSchema` link.
  */
-export type SiteSearchSourceInstancesTargetSchema = SiteSearchSource[];
+export type SearchIndexInstancesTargetSchema = SearchIndex[];
 /**
  * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
  * via the `instances.targetSchema` link.
@@ -2059,7 +2058,7 @@ export type Role = {
    */
   can_edit_site: boolean;
   /**
-   * Can create/edit models and plugins
+   * Can create and edit models and plugins
    */
   can_edit_schema: boolean;
   /**
@@ -2079,31 +2078,31 @@ export type Role = {
    */
   environments_access: 'all' | 'primary_only' | 'sandbox_only' | 'none';
   /**
-   * Can create/edit roles and invite/remove collaborators
+   * Can create and edit roles and invite/remove collaborators
    */
   can_manage_users: boolean;
   /**
-   * Can create/edit shared filters (both for models and the media area)
+   * Can create and edit shared filters (both for models and the media area)
    */
   can_manage_shared_filters: boolean;
   /**
-   * Can create/edit upload collections
+   * Can create and edit upload collections
    */
   can_manage_upload_collections: boolean;
   /**
-   * Can create/edit Build triggers
+   * Can create and edit build triggers
    */
   can_manage_build_triggers: boolean;
   /**
-   * Can create/edit Site Search Sources
+   * Can create and edit search indexes
    */
-  can_manage_site_search_sources: boolean;
+  can_manage_search_indexes: boolean;
   /**
-   * Can create/edit webhooks
+   * Can create and edit webhooks
    */
   can_manage_webhooks: boolean;
   /**
-   * Can create/delete sandbox environments and promote them to primary environment
+   * Can create and delete sandbox environments and promote them to primary environment
    */
   can_manage_environments: boolean;
   /**
@@ -2115,7 +2114,7 @@ export type Role = {
    */
   can_access_audit_log: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows: boolean;
   /**
@@ -2131,9 +2130,9 @@ export type Role = {
    */
   can_access_build_events_log: boolean;
   /**
-   * Can access the site search source events log
+   * Can access the search index events log
    */
-  can_access_site_search_source_events_log: boolean;
+  can_access_search_index_events_log: boolean;
   /**
    * Allowed actions on a model (or all) for a role
    */
@@ -2277,16 +2276,16 @@ export type Role = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed site search sources for a role
+   * Search indexes that can be triggered by a role
    */
-  positive_site_search_source_permissions: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  positive_search_index_permissions: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited site search sources for a role
+   * Search indexes that can't be triggered by a role
    */
-  negative_site_search_source_permissions: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  negative_search_index_permissions: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   inherits_permissions_from: RoleData[];
   meta: RoleMeta;
@@ -2326,7 +2325,7 @@ export type RoleMeta = {
      */
     can_edit_site: boolean;
     /**
-     * Can create/edit models and plugins
+     * Can create and edit models and plugins
      */
     can_edit_schema: boolean;
     /**
@@ -2346,31 +2345,31 @@ export type RoleMeta = {
      */
     environments_access: 'all' | 'primary_only' | 'sandbox_only' | 'none';
     /**
-     * Can create/edit roles and invite/remove collaborators
+     * Can create and edit roles and invite/remove collaborators
      */
     can_manage_users: boolean;
     /**
-     * Can create/edit shared filters (both for models and the media area)
+     * Can create and edit shared filters (both for models and the media area)
      */
     can_manage_shared_filters: boolean;
     /**
-     * Can create/edit upload collections
+     * Can create and edit upload collections
      */
     can_manage_upload_collections: boolean;
     /**
-     * Can create/edit Build triggers
+     * Can create and edit build triggers
      */
     can_manage_build_triggers: boolean;
     /**
-     * Can create/edit Site Search Sources
+     * Can create and edit search indexes
      */
-    can_manage_site_search_sources: boolean;
+    can_manage_search_indexes: boolean;
     /**
-     * Can create/edit webhooks
+     * Can create and edit webhooks
      */
     can_manage_webhooks: boolean;
     /**
-     * Can create/delete sandbox environments and promote them to primary environment
+     * Can create and delete sandbox environments and promote them to primary environment
      */
     can_manage_environments: boolean;
     /**
@@ -2382,7 +2381,7 @@ export type RoleMeta = {
      */
     can_access_audit_log: boolean;
     /**
-     * Can create/edit workflows
+     * Can create and edit workflows
      */
     can_manage_workflows: boolean;
     /**
@@ -2398,9 +2397,9 @@ export type RoleMeta = {
      */
     can_access_build_events_log: boolean;
     /**
-     * Can access the site search source events log
+     * Can access the search index events log
      */
-    can_access_site_search_source_events_log: boolean;
+    can_access_search_index_events_log: boolean;
     /**
      * Allowed actions on a model (or all) for a role
      */
@@ -2544,16 +2543,16 @@ export type RoleMeta = {
       build_trigger?: BuildTriggerIdentity | null;
     }[];
     /**
-     * Allowed site search sources for a role
+     * Search indexes that can be triggered by a role
      */
-    positive_site_search_source_permissions: {
-      site_search_source?: SiteSearchSourceIdentity | null;
+    positive_search_index_permissions: {
+      search_index?: SearchIndexIdentity | null;
     }[];
     /**
-     * Prohibited site search sources for a role
+     * Search indexes that can't be triggered by a role
      */
-    negative_site_search_source_permissions: {
-      site_search_source?: SiteSearchSourceIdentity | null;
+    negative_search_index_permissions: {
+      search_index?: SearchIndexIdentity | null;
     }[];
   };
 };
@@ -2577,7 +2576,7 @@ export type RoleAttributes = {
    */
   can_edit_site: boolean;
   /**
-   * Can create/edit models and plugins
+   * Can create and edit models and plugins
    */
   can_edit_schema: boolean;
   /**
@@ -2597,31 +2596,31 @@ export type RoleAttributes = {
    */
   environments_access: 'all' | 'primary_only' | 'sandbox_only' | 'none';
   /**
-   * Can create/edit roles and invite/remove collaborators
+   * Can create and edit roles and invite/remove collaborators
    */
   can_manage_users: boolean;
   /**
-   * Can create/edit shared filters (both for models and the media area)
+   * Can create and edit shared filters (both for models and the media area)
    */
   can_manage_shared_filters: boolean;
   /**
-   * Can create/edit upload collections
+   * Can create and edit upload collections
    */
   can_manage_upload_collections: boolean;
   /**
-   * Can create/edit Build triggers
+   * Can create and edit build triggers
    */
   can_manage_build_triggers: boolean;
   /**
-   * Can create/edit Site Search Sources
+   * Can create and edit search indexes
    */
-  can_manage_site_search_sources: boolean;
+  can_manage_search_indexes: boolean;
   /**
-   * Can create/edit webhooks
+   * Can create and edit webhooks
    */
   can_manage_webhooks: boolean;
   /**
-   * Can create/delete sandbox environments and promote them to primary environment
+   * Can create and delete sandbox environments and promote them to primary environment
    */
   can_manage_environments: boolean;
   /**
@@ -2633,7 +2632,7 @@ export type RoleAttributes = {
    */
   can_access_audit_log: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows: boolean;
   /**
@@ -2649,9 +2648,9 @@ export type RoleAttributes = {
    */
   can_access_build_events_log: boolean;
   /**
-   * Can access the site search source events log
+   * Can access the search index events log
    */
-  can_access_site_search_source_events_log: boolean;
+  can_access_search_index_events_log: boolean;
   /**
    * Allowed actions on a model (or all) for a role
    */
@@ -2795,16 +2794,16 @@ export type RoleAttributes = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed site search sources for a role
+   * Search indexes that can be triggered by a role
    */
-  positive_site_search_source_permissions: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  positive_search_index_permissions: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited site search sources for a role
+   * Search indexes that can't be triggered by a role
    */
-  negative_site_search_source_permissions: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  negative_search_index_permissions: {
+    search_index?: SearchIndexIdentity | null;
   }[];
 };
 /**
@@ -2835,7 +2834,7 @@ export type RoleCreateSchema = {
    */
   can_edit_site?: boolean;
   /**
-   * Can create/edit models and plugins
+   * Can create and edit models and plugins
    */
   can_edit_schema?: boolean;
   /**
@@ -2855,31 +2854,31 @@ export type RoleCreateSchema = {
    */
   environments_access?: 'all' | 'primary_only' | 'sandbox_only' | 'none';
   /**
-   * Can create/edit roles and invite/remove collaborators
+   * Can create and edit roles and invite/remove collaborators
    */
   can_manage_users?: boolean;
   /**
-   * Can create/edit shared filters (both for models and the media area)
+   * Can create and edit shared filters (both for models and the media area)
    */
   can_manage_shared_filters?: boolean;
   /**
-   * Can create/edit Site Search Sources
+   * Can create and edit search indexes
    */
-  can_manage_site_search_sources?: boolean;
+  can_manage_search_indexes?: boolean;
   /**
-   * Can create/edit upload collections
+   * Can create and edit upload collections
    */
   can_manage_upload_collections?: boolean;
   /**
-   * Can create/edit Build triggers
+   * Can create and edit build triggers
    */
   can_manage_build_triggers?: boolean;
   /**
-   * Can create/edit webhooks
+   * Can create and edit webhooks
    */
   can_manage_webhooks?: boolean;
   /**
-   * Can create/delete sandbox environments and promote them to primary environment
+   * Can create and delete sandbox environments and promote them to primary environment
    */
   can_manage_environments?: boolean;
   /**
@@ -2891,7 +2890,7 @@ export type RoleCreateSchema = {
    */
   can_access_audit_log?: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows?: boolean;
   /**
@@ -2907,9 +2906,9 @@ export type RoleCreateSchema = {
    */
   can_access_build_events_log?: boolean;
   /**
-   * Can access the site search source events log
+   * Can access the search index events log
    */
-  can_access_site_search_source_events_log?: boolean;
+  can_access_search_index_events_log?: boolean;
   /**
    * Allowed actions on a model (or all) for a role
    */
@@ -3053,16 +3052,16 @@ export type RoleCreateSchema = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed site search sources for a role
+   * Search indexes that can be triggered by a role
    */
-  positive_site_search_source_permissions?: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  positive_search_index_permissions?: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited site search sources for a role
+   * Search indexes that can't be triggered by a role
    */
-  negative_site_search_source_permissions?: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  negative_search_index_permissions?: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   inherits_permissions_from?: RoleData[];
   meta?: RoleMeta;
@@ -3087,7 +3086,7 @@ export type RoleUpdateSchema = {
    */
   can_edit_site?: boolean;
   /**
-   * Can create/edit models and plugins
+   * Can create and edit models and plugins
    */
   can_edit_schema?: boolean;
   /**
@@ -3107,31 +3106,31 @@ export type RoleUpdateSchema = {
    */
   environments_access?: 'all' | 'primary_only' | 'sandbox_only' | 'none';
   /**
-   * Can create/edit roles and invite/remove collaborators
+   * Can create and edit roles and invite/remove collaborators
    */
   can_manage_users?: boolean;
   /**
-   * Can create/edit shared filters (both for models and the media area)
+   * Can create and edit shared filters (both for models and the media area)
    */
   can_manage_shared_filters?: boolean;
   /**
-   * Can create/edit Site Search Sources
+   * Can create and edit search indexes
    */
-  can_manage_site_search_sources?: boolean;
+  can_manage_search_indexes?: boolean;
   /**
-   * Can create/edit upload collections
+   * Can create and edit upload collections
    */
   can_manage_upload_collections?: boolean;
   /**
-   * Can create/edit Build triggers
+   * Can create and edit build triggers
    */
   can_manage_build_triggers?: boolean;
   /**
-   * Can create/edit webhooks
+   * Can create and edit webhooks
    */
   can_manage_webhooks?: boolean;
   /**
-   * Can create/delete sandbox environments and promote them to primary environment
+   * Can create and delete sandbox environments and promote them to primary environment
    */
   can_manage_environments?: boolean;
   /**
@@ -3143,7 +3142,7 @@ export type RoleUpdateSchema = {
    */
   can_access_audit_log?: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows?: boolean;
   /**
@@ -3159,9 +3158,9 @@ export type RoleUpdateSchema = {
    */
   can_access_build_events_log?: boolean;
   /**
-   * Can access the site search source events log
+   * Can access the search index events log
    */
-  can_access_site_search_source_events_log?: boolean;
+  can_access_search_index_events_log?: boolean;
   /**
    * Allowed actions on a model (or all) for a role
    */
@@ -3305,16 +3304,16 @@ export type RoleUpdateSchema = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed site search sources for a role
+   * Search indexes that can be triggered by a role
    */
-  positive_site_search_source_permissions?: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  positive_search_index_permissions?: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited site search sources for a role
+   * Search indexes that can't be triggered by a role
    */
-  negative_site_search_source_permissions?: {
-    site_search_source?: SiteSearchSourceIdentity | null;
+  negative_search_index_permissions?: {
+    search_index?: SearchIndexIdentity | null;
   }[];
   inherits_permissions_from?: RoleData[];
   meta?: RoleMeta;
@@ -4017,9 +4016,9 @@ export type SitePlan = {
    */
   build_triggers: null | number;
   /**
-   * Number of site search sources
+   * Number of search indexes
    */
-  site_search_sources: null | number;
+  search_indexes: null | number;
   /**
    * Number of plugins
    */
@@ -4184,7 +4183,7 @@ export type SitePlan = {
       amount_per_packet: number;
       price: number;
     };
-    site_search_sources?: {
+    search_indexes?: {
       amount_per_packet: number;
       price: number;
     };
@@ -4261,9 +4260,9 @@ export type SitePlanAttributes = {
    */
   build_triggers: null | number;
   /**
-   * Number of site search sources
+   * Number of search indexes
    */
-  site_search_sources: null | number;
+  search_indexes: null | number;
   /**
    * Number of plugins
    */
@@ -4428,7 +4427,7 @@ export type SitePlanAttributes = {
       amount_per_packet: number;
       price: number;
     };
-    site_search_sources?: {
+    search_indexes?: {
       amount_per_packet: number;
       price: number;
     };
@@ -4944,7 +4943,26 @@ export type UploadCollectionUpdateSchema = {
   children?: UploadCollectionData[];
 };
 /**
- * The way you define the kind of content you can edit inside your administrative area passes through the concept of Models, which are much like database tables. For backward-compatibility reasons, the API refers to models as "item types".
+ * The way you define the kind of content you can edit inside a DatoCMS project passes through the concept of **models** and **block models**. For backward-compatibility reasons, the API refers to both as "item types".
+ *
+ * ## Models
+ *
+ * Models are much like database tables — they define the structure of your main content types (e.g., blog posts, products, landing pages). Each model is composed of fields with custom validations. Records created from models exist independently and can be referenced by other records through link fields.
+ *
+ * ## Block Models
+ *
+ * Block models define complex and repeatable structures that can be embedded inside records. They are the foundation behind features like [Modular Content](/docs/content-modelling/modular-content.md) and [Structured Text](/docs/content-modelling/structured-text.md).
+ *
+ * ### Key differences:
+ *
+ * - **Models** create standalone records that can be referenced and have independent value
+ * - **Block models** create blocks that only exist within parent records and cannot be referenced via link fields
+ * - Block models defined in the library can be reused across different models
+ * - When a record gets deleted, all the blocks it contains are deleted with it
+ * - Blocks do not count towards your plan's records limit
+ *
+ * You can distinguish between models and block models using the `modular_block` attribute: `true` indicates a block model, `false` indicates a regular model.
+ *
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "item_type".
@@ -4953,11 +4971,11 @@ export type ItemType = {
   id: ItemTypeIdentity;
   type: ItemTypeType;
   /**
-   * Name of the model
+   * Name of the model/block model
    */
   name: string;
   /**
-   * API key of the model
+   * API key of the model/block model
    */
   api_key: string;
   /**
@@ -4965,11 +4983,11 @@ export type ItemType = {
    */
   collection_appeareance?: 'compact' | 'table';
   /**
-   * The way the model collection should be presented to the editors
+   * The way the model/block model collection should be presented to the editors
    */
   collection_appearance: 'compact' | 'table';
   /**
-   * Whether the model is single-instance or not
+   * Whether the model is single-instance or not. This property only applies to models, not block models
    */
   singleton: boolean;
   /**
@@ -4977,31 +4995,31 @@ export type ItemType = {
    */
   all_locales_required: boolean;
   /**
-   * Whether editors can sort records via drag & drop or not
+   * Whether editors can sort records via drag & drop or not. Must be false for block models
    */
   sortable: boolean;
   /**
-   * Whether this model is a modular content block or not
+   * Whether this is a block model or not. Block models define structures that can be embedded inside records, while regular models create standalone records
    */
   modular_block: boolean;
   /**
-   * Whether draft/published mode is active or not
+   * Whether draft/published mode is active or not. Must be false for block models
    */
   draft_mode_active: boolean;
   /**
-   * Whether draft records can be saved without satisfying the validations or not
+   * Whether draft records can be saved without satisfying the validations or not. Must be false for block models
    */
   draft_saving_active: boolean;
   /**
-   * Whether editors can organize records in a tree or not
+   * Whether editors can organize records in a tree or not. Must be false for block models
    */
   tree: boolean;
   /**
-   * If an ordering field is set, this fields specify the sorting direction
+   * If an ordering field is set, this field specifies the sorting direction. This property does not apply to block models
    */
   ordering_direction: null | 'asc' | 'desc';
   /**
-   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field
+   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field. This property does not apply to block models
    */
   ordering_meta:
     | null
@@ -5010,15 +5028,15 @@ export type ItemType = {
     | 'first_published_at'
     | 'published_at';
   /**
-   * If this model is single-instance, this tells the single-instance record has already been created or not
+   * If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
    */
   has_singleton_item: boolean;
   /**
-   * A hint shown to editors to help them understand the purpose of this model/block
+   * A hint shown to editors to help them understand the purpose of this model/block model
    */
   hint: string | null;
   /**
-   * Whether inverse relationships fields are expressed in GraphQL or not
+   * Whether inverse relationships fields are expressed in GraphQL or not. Must be false for block models
    */
   inverse_relationships_enabled: boolean;
   singleton_item: ItemData | null;
@@ -5079,14 +5097,14 @@ export type WorkflowData = {
   id: WorkflowIdentity;
 };
 /**
- * Meta information regarding the item type
+ * Meta information regarding the model/block model
  *
  * This interface was referenced by `ItemType`'s JSON-Schema
  * via the `definition` "meta".
  */
 export type ItemTypeMeta = {
   /**
-   * If this model is single-instance, this tells the single-instance record has already been created or not
+   * If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
    */
   has_singleton_item: boolean;
 };
@@ -5098,11 +5116,11 @@ export type ItemTypeMeta = {
  */
 export type ItemTypeAttributes = {
   /**
-   * Name of the model
+   * Name of the model/block model
    */
   name: string;
   /**
-   * API key of the model
+   * API key of the model/block model
    */
   api_key: string;
   /**
@@ -5110,11 +5128,11 @@ export type ItemTypeAttributes = {
    */
   collection_appeareance?: 'compact' | 'table';
   /**
-   * The way the model collection should be presented to the editors
+   * The way the model/block model collection should be presented to the editors
    */
   collection_appearance: 'compact' | 'table';
   /**
-   * Whether the model is single-instance or not
+   * Whether the model is single-instance or not. This property only applies to models, not block models
    */
   singleton: boolean;
   /**
@@ -5122,31 +5140,31 @@ export type ItemTypeAttributes = {
    */
   all_locales_required: boolean;
   /**
-   * Whether editors can sort records via drag & drop or not
+   * Whether editors can sort records via drag & drop or not. Must be false for block models
    */
   sortable: boolean;
   /**
-   * Whether this model is a modular content block or not
+   * Whether this is a block model or not. Block models define structures that can be embedded inside records, while regular models create standalone records
    */
   modular_block: boolean;
   /**
-   * Whether draft/published mode is active or not
+   * Whether draft/published mode is active or not. Must be false for block models
    */
   draft_mode_active: boolean;
   /**
-   * Whether draft records can be saved without satisfying the validations or not
+   * Whether draft records can be saved without satisfying the validations or not. Must be false for block models
    */
   draft_saving_active: boolean;
   /**
-   * Whether editors can organize records in a tree or not
+   * Whether editors can organize records in a tree or not. Must be false for block models
    */
   tree: boolean;
   /**
-   * If an ordering field is set, this fields specify the sorting direction
+   * If an ordering field is set, this field specifies the sorting direction. This property does not apply to block models
    */
   ordering_direction: null | 'asc' | 'desc';
   /**
-   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field
+   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field. This property does not apply to block models
    */
   ordering_meta:
     | null
@@ -5155,15 +5173,15 @@ export type ItemTypeAttributes = {
     | 'first_published_at'
     | 'published_at';
   /**
-   * If this model is single-instance, this tells the single-instance record has already been created or not
+   * If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
    */
   has_singleton_item: boolean;
   /**
-   * A hint shown to editors to help them understand the purpose of this model/block
+   * A hint shown to editors to help them understand the purpose of this model/block model
    */
   hint: string | null;
   /**
-   * Whether inverse relationships fields are expressed in GraphQL or not
+   * Whether inverse relationships fields are expressed in GraphQL or not. Must be false for block models
    */
   inverse_relationships_enabled: boolean;
 };
@@ -5193,15 +5211,15 @@ export type ItemTypeCreateSchema = {
   id?: ItemTypeIdentity;
   type?: ItemTypeType;
   /**
-   * Name of the model
+   * Name of the model/block model
    */
   name: string;
   /**
-   * API key of the model
+   * API key of the model/block model
    */
   api_key: string;
   /**
-   * Whether the model is single-instance or not
+   * Whether the model is single-instance or not. This property only applies to models, not block models
    */
   singleton?: boolean;
   /**
@@ -5209,31 +5227,31 @@ export type ItemTypeCreateSchema = {
    */
   all_locales_required?: boolean;
   /**
-   * Whether editors can sort records via drag & drop or not
+   * Whether editors can sort records via drag & drop or not. Must be false for block models
    */
   sortable?: boolean;
   /**
-   * Whether this model is a modular content block or not
+   * Whether this is a block model or not. Block models define structures that can be embedded inside records, while regular models create standalone records
    */
   modular_block?: boolean;
   /**
-   * Whether draft/published mode is active or not
+   * Whether draft/published mode is active or not. Must be false for block models
    */
   draft_mode_active?: boolean;
   /**
-   * Whether draft records can be saved without satisfying the validations or not
+   * Whether draft records can be saved without satisfying the validations or not. Must be false for block models
    */
   draft_saving_active?: boolean;
   /**
-   * Whether editors can organize records in a tree or not
+   * Whether editors can organize records in a tree or not. Must be false for block models
    */
   tree?: boolean;
   /**
-   * If an ordering field is set, this fields specify the sorting direction
+   * If an ordering field is set, this field specifies the sorting direction. This property does not apply to block models
    */
   ordering_direction?: null | 'asc' | 'desc';
   /**
-   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field
+   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field. This property does not apply to block models
    */
   ordering_meta?:
     | null
@@ -5246,15 +5264,15 @@ export type ItemTypeCreateSchema = {
    */
   collection_appeareance?: 'compact' | 'table';
   /**
-   * The way the model collection should be presented to the editors
+   * The way the model/block model collection should be presented to the editors
    */
   collection_appearance?: 'compact' | 'table';
   /**
-   * A hint shown to editors to help them understand the purpose of this model/block
+   * A hint shown to editors to help them understand the purpose of this model/block model
    */
   hint?: string | null;
   /**
-   * Whether inverse relationships fields are expressed in GraphQL or not
+   * Whether inverse relationships fields are expressed in GraphQL or not. Must be false for block models
    */
   inverse_relationships_enabled?: boolean;
   ordering_field?: FieldData | null;
@@ -5273,11 +5291,11 @@ export type ItemTypeUpdateSchema = {
   id?: ItemTypeIdentity;
   type?: ItemTypeType;
   /**
-   * Name of the model
+   * Name of the model/block model
    */
   name?: string;
   /**
-   * API key of the model
+   * API key of the model/block model
    */
   api_key?: string;
   /**
@@ -5285,11 +5303,11 @@ export type ItemTypeUpdateSchema = {
    */
   collection_appeareance?: 'compact' | 'table';
   /**
-   * The way the model collection should be presented to the editors
+   * The way the model/block model collection should be presented to the editors
    */
   collection_appearance?: 'compact' | 'table';
   /**
-   * Whether the model is single-instance or not
+   * Whether the model is single-instance or not. This property only applies to models, not block models
    */
   singleton?: boolean;
   /**
@@ -5297,31 +5315,31 @@ export type ItemTypeUpdateSchema = {
    */
   all_locales_required?: boolean;
   /**
-   * Whether editors can sort records via drag & drop or not
+   * Whether editors can sort records via drag & drop or not. Must be false for block models
    */
   sortable?: boolean;
   /**
-   * Whether this model is a modular content block or not
+   * Whether this is a block model or not. Block models define structures that can be embedded inside records, while regular models create standalone records
    */
   modular_block?: boolean;
   /**
-   * Whether draft/published mode is active or not
+   * Whether draft/published mode is active or not. Must be false for block models
    */
   draft_mode_active?: boolean;
   /**
-   * Whether draft records can be saved without satisfying the validations or not
+   * Whether draft records can be saved without satisfying the validations or not. Must be false for block models
    */
   draft_saving_active?: boolean;
   /**
-   * Whether editors can organize records in a tree or not
+   * Whether editors can organize records in a tree or not. Must be false for block models
    */
   tree?: boolean;
   /**
-   * If an ordering field is set, this fields specify the sorting direction
+   * If an ordering field is set, this field specifies the sorting direction. This property does not apply to block models
    */
   ordering_direction?: null | 'asc' | 'desc';
   /**
-   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field
+   * Specifies the model's sorting method. Cannot be set in concurrency with ordering_field. This property does not apply to block models
    */
   ordering_meta?:
     | null
@@ -5330,15 +5348,15 @@ export type ItemTypeUpdateSchema = {
     | 'first_published_at'
     | 'published_at';
   /**
-   * If this model is single-instance, this tells the single-instance record has already been created or not
+   * If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
    */
   has_singleton_item?: boolean;
   /**
-   * A hint shown to editors to help them understand the purpose of this model/block
+   * A hint shown to editors to help them understand the purpose of this model/block model
    */
   hint?: string | null;
   /**
-   * Whether inverse relationships fields are expressed in GraphQL or not
+   * Whether inverse relationships fields are expressed in GraphQL or not. Must be false for block models
    */
   inverse_relationships_enabled?: boolean;
   ordering_field?: FieldData | null;
@@ -5350,7 +5368,7 @@ export type ItemTypeUpdateSchema = {
   workflow?: WorkflowData | null;
   meta?: {
     /**
-     * If this model is single-instance, this tells the single-instance record has already been created or not
+     * If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
      */
     has_singleton_item?: boolean;
   };
@@ -7419,7 +7437,7 @@ export type SubscriptionFeatureAttributes = {
   enabled: boolean;
 };
 /**
- * Represents an event occurred during the deploy process of your administrative area.
+ * Represents an event occurred during the deploy process of a build trigger.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "build_event".
@@ -7508,14 +7526,14 @@ export type BuildEventRelationships = {
   build_trigger: BuildTriggerData;
 };
 /**
- * Represents an event occurred during the site search indexing process.
+ * Represents an event occurred during the indexing process via search indexes.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
- * via the `definition` "site_search_source_event".
+ * via the `definition` "search_index_event".
  */
-export type SiteSearchSourceEvent = {
-  id: SiteSearchSourceEventIdentity;
-  type: SiteSearchSourceEventType;
+export type SearchIndexEvent = {
+  id: SearchIndexEventIdentity;
+  type: SearchIndexEventType;
   /**
    * The type of activity
    */
@@ -7534,36 +7552,36 @@ export type SiteSearchSourceEvent = {
   data: {
     [k: string]: unknown;
   };
-  site_search_source: SiteSearchSourceData;
+  search_index: SearchIndexData;
 };
-export type SiteSearchSourceEventSelfTargetSchema = SiteSearchSourceEvent;
+export type SearchIndexEventSelfTargetSchema = SearchIndexEvent;
 /**
  * JSON API data
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "data".
  */
-export type SiteSearchSourceData = {
-  type: SiteSearchSourceType;
-  id: SiteSearchSourceIdentity;
+export type SearchIndexData = {
+  type: SearchIndexType;
+  id: SearchIndexIdentity;
 };
 /**
  * JSON API data
  *
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "data".
  */
-export type SiteSearchSourceEventData = {
-  type: SiteSearchSourceEventType;
-  id: SiteSearchSourceEventIdentity;
+export type SearchIndexEventData = {
+  type: SearchIndexEventType;
+  id: SearchIndexEventIdentity;
 };
 /**
  * JSON API attributes
  *
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "attributes".
  */
-export type SiteSearchSourceEventAttributes = {
+export type SearchIndexEventAttributes = {
   /**
    * The type of activity
    */
@@ -7586,11 +7604,11 @@ export type SiteSearchSourceEventAttributes = {
 /**
  * JSON API links
  *
- * This interface was referenced by `SiteSearchSourceEvent`'s JSON-Schema
+ * This interface was referenced by `SearchIndexEvent`'s JSON-Schema
  * via the `definition` "relationships".
  */
-export type SiteSearchSourceEventRelationships = {
-  site_search_source: SiteSearchSourceData;
+export type SearchIndexEventRelationships = {
+  search_index: SearchIndexData;
 };
 export type ItemCreateTargetSchema<
   D extends ItemTypeDefinition = ItemTypeDefinition,
@@ -9735,6 +9753,10 @@ export type BuildTrigger = {
    * Name of the build trigger
    */
   name: string;
+  /**
+   * Whether the build trigger is enabled or not
+   */
+  enabled: boolean;
   /**
    * The type of build trigger
    */
@@ -9766,7 +9788,7 @@ export type BuildTrigger = {
    */
   indexing_status: string;
   /**
-   * The public URL of the frontend. If Site Search is enabled (indicated by `indexing_enabled`), this is the starting point from which the website's spidering will start
+   * The public URL of the frontend.
    */
   frontend_url: string | null;
   /**
@@ -9777,10 +9799,6 @@ export type BuildTrigger = {
    * Wether Site Search is enabled or not. With Site Search, everytime the website is built, DatoCMS will respider it to get updated content
    */
   indexing_enabled: boolean;
-  /**
-   * Whether the build trigger is enabled or not
-   */
-  enabled: boolean;
 };
 export type BuildTriggerSelfTargetSchema = BuildTrigger;
 export type BuildTriggerCreateTargetSchema = BuildTrigger;
@@ -9797,6 +9815,10 @@ export type BuildTriggerAttributes = {
    * Name of the build trigger
    */
   name: string;
+  /**
+   * Whether the build trigger is enabled or not
+   */
+  enabled: boolean;
   /**
    * The type of build trigger
    */
@@ -9828,7 +9850,7 @@ export type BuildTriggerAttributes = {
    */
   indexing_status: string;
   /**
-   * The public URL of the frontend. If Site Search is enabled (indicated by `indexing_enabled`), this is the starting point from which the website's spidering will start
+   * The public URL of the frontend.
    */
   frontend_url: string | null;
   /**
@@ -9839,10 +9861,6 @@ export type BuildTriggerAttributes = {
    * Wether Site Search is enabled or not. With Site Search, everytime the website is built, DatoCMS will respider it to get updated content
    */
   indexing_enabled: boolean;
-  /**
-   * Whether the build trigger is enabled or not
-   */
-  enabled: boolean;
 };
 /**
  * This interface was referenced by `BuildTrigger`'s JSON-Schema
@@ -9865,13 +9883,13 @@ export type BuildTriggerCreateSchema = {
   /**
    * Wether Site Search is enabled or not. With Site Search, everytime the website is built, DatoCMS will respider it to get updated content
    */
-  indexing_enabled: boolean;
+  indexing_enabled?: boolean;
   /**
    * Whether the build trigger is enabled or not
    */
   enabled?: boolean;
   /**
-   * The public URL of the frontend. If Site Search is enabled (indicated by `indexing_enabled`), this is the starting point from which the website's spidering will start
+   * The public URL of the frontend.
    */
   frontend_url: string | null;
   /**
@@ -9909,7 +9927,7 @@ export type BuildTriggerUpdateSchema = {
    */
   enabled?: boolean;
   /**
-   * The public URL of the frontend. If Site Search is enabled (indicated by `indexing_enabled`), this is the starting point from which the website's spidering will start
+   * The public URL of the frontend.
    */
   frontend_url?: string | null;
   /**
@@ -9924,28 +9942,24 @@ export type BuildTriggerUpdateSchema = {
   };
 };
 /**
- * A Site Search Source represents a website that should be indexed by DatoCMS Site Search. When enabled, DatoCMS will periodically spider the website to update the search index.
+ * A Search Index is used to index a website to provide DatoCMS Site Search functionality.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
- * via the `definition` "site_search_source".
+ * via the `definition` "search_index".
  */
-export type SiteSearchSource = {
-  id: SiteSearchSourceIdentity;
-  type: SiteSearchSourceType;
+export type SearchIndex = {
+  id: SearchIndexIdentity;
+  type: SearchIndexType;
   /**
-   * Name of the site search source
+   * Name of the search index
    */
   name: string;
   /**
-   * Whether the site search source is enabled or not
+   * Whether the search index is enabled or not
    */
   enabled: boolean;
   /**
-   * Whether the spidering should automatically run after associated build triggers complete
-   */
-  build_trigger_indexing_enabled: boolean;
-  /**
-   * The public URL of the frontend. This is the starting point from which the website's spidering will start
+   * The public URL of the website. This is the starting point from which the website's spidering will start
    */
   frontend_url: string | null;
   /**
@@ -9953,21 +9967,21 @@ export type SiteSearchSource = {
    */
   user_agent_suffix: string | null;
   build_triggers: BuildTriggerData[];
-  meta: SiteSearchSourceMeta;
+  meta: SearchIndexMeta;
 };
-export type SiteSearchSourceSelfTargetSchema = SiteSearchSource;
-export type SiteSearchSourceCreateTargetSchema = SiteSearchSource;
-export type SiteSearchSourceUpdateTargetSchema = SiteSearchSource;
-export type SiteSearchSourceDestroyTargetSchema = SiteSearchSource;
+export type SearchIndexSelfTargetSchema = SearchIndex;
+export type SearchIndexCreateTargetSchema = SearchIndex;
+export type SearchIndexUpdateTargetSchema = SearchIndex;
+export type SearchIndexDestroyTargetSchema = SearchIndex;
 /**
- * Meta information about the site search source
+ * Meta information about the search index
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "meta".
  */
-export type SiteSearchSourceMeta = {
+export type SearchIndexMeta = {
   /**
-   * Status of the site search indexing
+   * Status of the search indexing
    */
   indexing_status: 'unstarted' | 'pending' | 'success' | 'failed';
   /**
@@ -9978,24 +9992,20 @@ export type SiteSearchSourceMeta = {
 /**
  * JSON API attributes
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "attributes".
  */
-export type SiteSearchSourceAttributes = {
+export type SearchIndexAttributes = {
   /**
-   * Name of the site search source
+   * Name of the search index
    */
   name: string;
   /**
-   * Whether the site search source is enabled or not
+   * Whether the search index is enabled or not
    */
   enabled: boolean;
   /**
-   * Whether the spidering should automatically run after associated build triggers complete
-   */
-  build_trigger_indexing_enabled: boolean;
-  /**
-   * The public URL of the frontend. This is the starting point from which the website's spidering will start
+   * The public URL of the website. This is the starting point from which the website's spidering will start
    */
   frontend_url: string | null;
   /**
@@ -10006,32 +10016,28 @@ export type SiteSearchSourceAttributes = {
 /**
  * JSON API links
  *
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `definition` "relationships".
  */
-export type SiteSearchSourceRelationships = {
+export type SearchIndexRelationships = {
   build_triggers: BuildTriggerData[];
 };
 /**
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `create.schema` link.
  */
-export type SiteSearchSourceCreateSchema = {
-  type?: SiteSearchSourceType;
+export type SearchIndexCreateSchema = {
+  type?: SearchIndexType;
   /**
-   * Name of the site search source
+   * Name of the search index
    */
   name: string;
   /**
-   * Whether the site search source is enabled or not
+   * Whether the search index is enabled or not
    */
   enabled: boolean;
   /**
-   * Whether the spidering should automatically run after associated build triggers complete
-   */
-  build_trigger_indexing_enabled?: boolean;
-  /**
-   * The public URL of the frontend. This is the starting point from which the website's spidering will start
+   * The public URL of the website. This is the starting point from which the website's spidering will start
    */
   frontend_url: string | null;
   /**
@@ -10041,26 +10047,22 @@ export type SiteSearchSourceCreateSchema = {
   build_triggers?: BuildTriggerData[];
 };
 /**
- * This interface was referenced by `SiteSearchSource`'s JSON-Schema
+ * This interface was referenced by `SearchIndex`'s JSON-Schema
  * via the `update.schema` link.
  */
-export type SiteSearchSourceUpdateSchema = {
-  id?: SiteSearchSourceIdentity;
-  type?: SiteSearchSourceType;
+export type SearchIndexUpdateSchema = {
+  id?: SearchIndexIdentity;
+  type?: SearchIndexType;
   /**
-   * Name of the site search source
+   * Name of the search index
    */
   name?: string;
   /**
-   * Whether the site search source is enabled or not
+   * Whether the search index is enabled or not
    */
   enabled?: boolean;
   /**
-   * Whether the spidering should automatically run after associated build triggers complete
-   */
-  build_trigger_indexing_enabled?: boolean;
-  /**
-   * The public URL of the frontend. This is the starting point from which the website's spidering will start
+   * The public URL of the website. This is the starting point from which the website's spidering will start
    */
   frontend_url?: string | null;
   /**