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

package/src/generated/ApiTypes.ts

@@ -962,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>;
     /**
@@ -1043,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;
@@ -1421,11 +1421,11 @@ export type SearchResultInstancesHrefSchema = {
      */
     query: string;
     /**
-     * The search index ID or name on which the search will be performed. If not provided, the first enabled search index 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.
      */
     search_index_id?: string;
     /**
-     * **[Deprecated]** Use `search_index_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 search indexes associated.
+     * The build trigger ID or name on which the search will be performed.
      */
     build_trigger_id?: string;
     /**
@@ -2058,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;
   /**
@@ -2078,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 Search Indexes
+   * Can create and edit search indexes
    */
   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;
   /**
@@ -2114,7 +2114,7 @@ export type Role = {
    */
   can_access_audit_log: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows: boolean;
   /**
@@ -2276,13 +2276,13 @@ export type Role = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed search indexes for a role
+   * Search indexes that can be triggered by a role
    */
   positive_search_index_permissions: {
     search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited search indexes for a role
+   * Search indexes that can't be triggered by a role
    */
   negative_search_index_permissions: {
     search_index?: SearchIndexIdentity | null;
@@ -2325,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;
     /**
@@ -2345,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 Search Indexes
+     * Can create and edit search indexes
      */
     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;
     /**
@@ -2381,7 +2381,7 @@ export type RoleMeta = {
      */
     can_access_audit_log: boolean;
     /**
-     * Can create/edit workflows
+     * Can create and edit workflows
      */
     can_manage_workflows: boolean;
     /**
@@ -2543,13 +2543,13 @@ export type RoleMeta = {
       build_trigger?: BuildTriggerIdentity | null;
     }[];
     /**
-     * Allowed search indexes for a role
+     * Search indexes that can be triggered by a role
      */
     positive_search_index_permissions: {
       search_index?: SearchIndexIdentity | null;
     }[];
     /**
-     * Prohibited search indexes for a role
+     * Search indexes that can't be triggered by a role
      */
     negative_search_index_permissions: {
       search_index?: SearchIndexIdentity | null;
@@ -2576,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;
   /**
@@ -2596,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 Search Indexes
+   * Can create and edit search indexes
    */
   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;
   /**
@@ -2632,7 +2632,7 @@ export type RoleAttributes = {
    */
   can_access_audit_log: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows: boolean;
   /**
@@ -2794,13 +2794,13 @@ export type RoleAttributes = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed search indexes for a role
+   * Search indexes that can be triggered by a role
    */
   positive_search_index_permissions: {
     search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited search indexes for a role
+   * Search indexes that can't be triggered by a role
    */
   negative_search_index_permissions: {
     search_index?: SearchIndexIdentity | null;
@@ -2834,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;
   /**
@@ -2854,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 Search Indexes
+   * Can create and edit search indexes
    */
   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;
   /**
@@ -2890,7 +2890,7 @@ export type RoleCreateSchema = {
    */
   can_access_audit_log?: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows?: boolean;
   /**
@@ -3052,13 +3052,13 @@ export type RoleCreateSchema = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed search indexes for a role
+   * Search indexes that can be triggered by a role
    */
   positive_search_index_permissions?: {
     search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited search indexes for a role
+   * Search indexes that can't be triggered by a role
    */
   negative_search_index_permissions?: {
     search_index?: SearchIndexIdentity | null;
@@ -3086,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;
   /**
@@ -3106,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 Search Indexes
+   * Can create and edit search indexes
    */
   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;
   /**
@@ -3142,7 +3142,7 @@ export type RoleUpdateSchema = {
    */
   can_access_audit_log?: boolean;
   /**
-   * Can create/edit workflows
+   * Can create and edit workflows
    */
   can_manage_workflows?: boolean;
   /**
@@ -3304,13 +3304,13 @@ export type RoleUpdateSchema = {
     build_trigger?: BuildTriggerIdentity | null;
   }[];
   /**
-   * Allowed search indexes for a role
+   * Search indexes that can be triggered by a role
    */
   positive_search_index_permissions?: {
     search_index?: SearchIndexIdentity | null;
   }[];
   /**
-   * Prohibited search indexes for a role
+   * Search indexes that can't be triggered by a role
    */
   negative_search_index_permissions?: {
     search_index?: SearchIndexIdentity | null;
@@ -4943,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".
@@ -4952,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;
   /**
@@ -4964,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;
   /**
@@ -4976,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
@@ -5009,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;
@@ -5078,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;
 };
@@ -5097,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;
   /**
@@ -5109,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;
   /**
@@ -5121,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
@@ -5154,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;
 };
@@ -5192,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;
   /**
@@ -5208,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
@@ -5245,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;
@@ -5272,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;
   /**
@@ -5284,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;
   /**
@@ -5296,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
@@ -5329,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;
@@ -5349,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;
   };
@@ -7418,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".
@@ -7507,7 +7526,7 @@ export type BuildEventRelationships = {
   build_trigger: BuildTriggerData;
 };
 /**
- * Represents an event occurred during the 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` "search_index_event".
@@ -9734,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
    */
@@ -9765,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;
   /**
@@ -9776,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;
@@ -9796,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
    */
@@ -9827,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;
   /**
@@ -9838,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
@@ -9864,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;
   /**
@@ -9908,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;
   /**
@@ -9923,7 +9942,7 @@ export type BuildTriggerUpdateSchema = {
   };
 };
 /**
- * A Search Index 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` "search_index".
@@ -9940,11 +9959,7 @@ export type SearchIndex = {
    */
   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;
   /**
@@ -9966,7 +9981,7 @@ export type SearchIndexDestroyTargetSchema = SearchIndex;
  */
 export type SearchIndexMeta = {
   /**
-   * Status of the site search indexing
+   * Status of the search indexing
    */
   indexing_status: 'unstarted' | 'pending' | 'success' | 'failed';
   /**
@@ -9990,11 +10005,7 @@ export type SearchIndexAttributes = {
    */
   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;
   /**
@@ -10026,11 +10037,7 @@ export type SearchIndexCreateSchema = {
    */
   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;
   /**
@@ -10055,11 +10062,7 @@ export type SearchIndexUpdateSchema = {
    */
   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;
   /**