@epilot/entity-client 7.1.1 → 7.2.0-rc1

package/dist/openapi.d.ts

@@ -20,7 +20,9 @@ declare namespace Components {
          * 01F130Q52Q6MWSNS8N2AVXV4JN
          */
         Schemas.ActivityId /* ulid ^01[0-9a-zA-Z]{24}$ */ | ("" | null);
+        export type ApplyChangesetsQueryParam = boolean;
         export type AsyncOperationQueryParam = boolean;
+        export type DirectQueryParam = boolean;
         export type DryRunQueryParam = boolean;
         export type EntityIdPathParam = Schemas.EntityId /* uuid */;
         export type EntityRelationsModeQueryParam = "direct" | "reverse" | "both";
@@ -89,6 +91,8 @@ declare namespace Components {
         DryRunQueryParam?: Parameters.DryRunQueryParam;
         FillActivityQueryParam?: Parameters.FillActivityQueryParam;
         ValidateEntityQueryParam?: Parameters.ValidateEntityQueryParam;
+        DirectQueryParam?: Parameters.DirectQueryParam;
+        ApplyChangesetsQueryParam?: Parameters.ApplyChangesetsQueryParam;
     }
     namespace Responses {
         /**
@@ -174,6 +178,10 @@ declare namespace Components {
              * - RelationsSoftDeleted
              * - RelationsRestored
              * - RelationsDeleted
+             * - ChangesetCreated
+             * - ChangesetAutoCleared
+             * - ChangesetApplied
+             * - ChangesetDismissed
              *
              */
             ActivityType;
@@ -287,6 +295,10 @@ declare namespace Components {
              * - RelationsSoftDeleted
              * - RelationsRestored
              * - RelationsDeleted
+             * - ChangesetCreated
+             * - ChangesetAutoCleared
+             * - ChangesetApplied
+             * - ChangesetDismissed
              *
              */
             ActivityType;
@@ -343,6 +355,10 @@ declare namespace Components {
          * - RelationsSoftDeleted
          * - RelationsRestored
          * - RelationsDeleted
+         * - ChangesetCreated
+         * - ChangesetAutoCleared
+         * - ChangesetApplied
+         * - ChangesetDismissed
          *
          */
         export type ActivityType = string;
@@ -499,6 +515,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "address";
             default_address_fields?: /**
              * Default fields visible on addresses
@@ -680,6 +705,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "relation_address";
             default_address_fields?: /**
              * Default fields visible on addresses
@@ -878,6 +912,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "automation";
         }
         export interface BaseActivityItem {
@@ -902,6 +945,10 @@ declare namespace Components {
              * - RelationsSoftDeleted
              * - RelationsRestored
              * - RelationsDeleted
+             * - ChangesetCreated
+             * - ChangesetAutoCleared
+             * - ChangesetApplied
+             * - ChangesetDismissed
              *
              */
             ActivityType;
@@ -1087,6 +1134,18 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            /**
+             * Configuration for non-direct edit modes. Required when edit_mode is external or approval with fuzzy match strategy.
+             */
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
         }
         /**
          * example:
@@ -1169,6 +1228,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
         }
         /**
          * Reference to blueprint
@@ -1327,9 +1395,71 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "boolean";
             display_type?: "switch" | "checkbox";
         }
+        /**
+         * A pending proposed change for a single entity attribute, awaiting external confirmation or human approval.
+         */
+        export interface Changeset {
+            /**
+             * The proposed new value for the attribute. Type matches the attribute type.
+             */
+            proposed_value: any;
+            /**
+             * The attribute value at the time the changeset was created. Stored for reference.
+             */
+            previous_value?: any;
+            /**
+             * Timestamp when the changeset was created
+             */
+            created_at: string; // date-time
+            created_by?: /* Identifies the actor that created the changeset. */ ChangesetCreator;
+            /**
+             * The edit mode that triggered this changeset
+             */
+            edit_mode: "external" | "approval";
+            match_strategy?: /**
+             * Strategy for auto-clearing the changeset when an external update is received.
+             * - `exact`: The inbound value must exactly match the proposed value (deep equality).
+             * - `fuzzy`: The inbound value is compared using the configured fuzzy algorithm.
+             * - `any`: Any update to the attribute clears the changeset, regardless of value.
+             *
+             */
+            MatchStrategy;
+            /**
+             * Optional label indicating where the change originated (e.g. end_customer_portal, installer_portal, journey, automation)
+             */
+            source?: string;
+        }
+        /**
+         * Identifies the actor that created the changeset.
+         */
+        export interface ChangesetCreator {
+            /**
+             * Type of actor that created the changeset
+             */
+            type?: "user" | "portal_user" | "api_client" | "automation";
+            /**
+             * ID of the actor (user ID, portal user ID, API client ID, etc.)
+             */
+            id?: string;
+        }
+        /**
+         * Map of attribute name to pending changeset. At most one changeset per attribute.
+         */
+        export interface ChangesetMap {
+            [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+        }
         /**
          * example:
          * taxonomy-slug:classification-slug
@@ -1525,6 +1655,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "computed";
             computed?: boolean;
             /**
@@ -1689,6 +1828,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "consent";
             topic: string;
             identifiers?: string[];
@@ -1846,6 +1994,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "country";
         }
         /**
@@ -2001,6 +2158,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "currency";
             currency_selector_only?: boolean;
             /**
@@ -2166,6 +2332,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "date" | "datetime";
         }
         /**
@@ -2204,6 +2379,20 @@ declare namespace Components {
              */
             cluster?: string;
         }
+        /**
+         * Configuration for non-direct edit modes on an entity attribute.
+         */
+        export interface EditModeConfig {
+            match_strategy?: /**
+             * Strategy for auto-clearing the changeset when an external update is received.
+             * - `exact`: The inbound value must exactly match the proposed value (deep equality).
+             * - `fuzzy`: The inbound value is compared using the configured fuzzy algorithm.
+             * - `any`: Any update to the attribute clears the changeset, regardless of value.
+             *
+             */
+            MatchStrategy;
+            fuzzy_config?: /* Configuration for fuzzy match strategies on changeset auto-clearing. */ FuzzyConfig;
+        }
         /**
          * Email address
          */
@@ -2357,6 +2546,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "email";
         }
         /**
@@ -2440,6 +2638,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
         }
         /**
          * Access control list (ACL) for an entity. Defines sharing access to external orgs or users.
@@ -2935,6 +3142,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
         }
         export interface EntityListParams {
             /**
@@ -3111,6 +3327,10 @@ declare namespace Components {
              * - RelationsSoftDeleted
              * - RelationsRestored
              * - RelationsDeleted
+             * - ChangesetCreated
+             * - ChangesetAutoCleared
+             * - ChangesetApplied
+             * - ChangesetDismissed
              *
              */
             ActivityType;
@@ -3213,6 +3433,15 @@ declare namespace Components {
                  * Manifest ID used to create/update the entity
                  */
                 _manifest?: string /* uuid */[] | null;
+                /**
+                 * Pending attribute changesets for attributes configured with external or approval edit mode.
+                 * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+                 * Use the changeset management endpoints to apply or dismiss changesets.
+                 *
+                 */
+                _changesets?: {
+                    [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+                } | null;
             };
             diff?: {
                 /**
@@ -3297,6 +3526,15 @@ declare namespace Components {
                      * Manifest ID used to create/update the entity
                      */
                     _manifest?: string /* uuid */[] | null;
+                    /**
+                     * Pending attribute changesets for attributes configured with external or approval edit mode.
+                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     */
+                    _changesets?: {
+                        [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+                    } | null;
                 };
                 /**
                  * Attributes updated in the entity. Note: These values contain the previous values before the update!
@@ -3380,6 +3618,15 @@ declare namespace Components {
                      * Manifest ID used to create/update the entity
                      */
                     _manifest?: string /* uuid */[] | null;
+                    /**
+                     * Pending attribute changesets for attributes configured with external or approval edit mode.
+                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     */
+                    _changesets?: {
+                        [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+                    } | null;
                 };
                 /**
                  * Attributes removed from the entity as part of the operation
@@ -3463,6 +3710,15 @@ declare namespace Components {
                      * Manifest ID used to create/update the entity
                      */
                     _manifest?: string /* uuid */[] | null;
+                    /**
+                     * Pending attribute changesets for attributes configured with external or approval edit mode.
+                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     */
+                    _changesets?: {
+                        [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+                    } | null;
                 };
             };
             /**
@@ -3728,6 +3984,10 @@ declare namespace Components {
              */
             attributes: Attribute[];
             _purpose?: string[];
+            /**
+             * Manifest ID used to create the schema
+             */
+            _manifest?: string /* uuid */[] | null;
             explicit_search_mappings?: /**
              * Advanced: explicit Elasticsearch index mapping definitions for entity data
              *
@@ -4120,6 +4380,10 @@ declare namespace Components {
              */
             attributes: Attribute[];
             _purpose?: string[];
+            /**
+             * Manifest ID used to create the schema
+             */
+            _manifest?: string /* uuid */[] | null;
             explicit_search_mappings?: /**
              * Advanced: explicit Elasticsearch index mapping definitions for entity data
              *
@@ -4788,6 +5052,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "image" | "file";
             multiple?: boolean;
             /**
@@ -4806,6 +5079,39 @@ declare namespace Components {
             enable_description?: boolean;
             default_access_control?: "public-read" | "private";
         }
+        /**
+         * Configuration for fuzzy match strategies on changeset auto-clearing.
+         */
+        export interface FuzzyConfig {
+            /**
+             * Which fuzzy algorithm to apply.
+             */
+            type: "suffix" | "digits_only" | "normalize_phone" | "ignore_fields" | "contains_entry" | "regex";
+            /**
+             * For type=suffix: number of characters to compare from end of string.
+             */
+            suffix_length?: number;
+            /**
+             * For type=ignore_fields: field names to exclude when comparing array entries.
+             */
+            fields_to_ignore?: string[];
+            /**
+             * For type=regex: flags to apply to the regex (e.g. 'i' for case-insensitive).
+             */
+            regex_flags?: string;
+            /**
+             * For type=normalize_phone: country dialing code digits to strip (e.g. '49' for Germany). No '+' prefix.
+             */
+            country_code?: string;
+            /**
+             * For type=normalize_phone and type=contains_entry: attribute key(s) within array entries to compare on.
+             */
+            match_on?: string;
+            /**
+             * For type=regex: regular expression pattern to test the incoming value against.
+             */
+            pattern?: string;
+        }
         export interface GenerateEntityTableAIFiltersRequest {
             /**
              * The prompt to generate the filters
@@ -4973,6 +5279,10 @@ declare namespace Components {
              * If true, return full entity objects in entityNodes instead of just entity IDs in nodes
              */
             hydrate?: boolean;
+            /**
+             * When true and hydrate is also true, entity objects in entityNodes have pending changeset proposed values applied in-place. The _changesets field is still included in the response.
+             */
+            apply_changesets?: boolean;
         }
         export interface GraphQueryResponse {
             /**
@@ -5389,6 +5699,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
             _relations: {
                 entity_id: EntityId /* uuid */;
             }[];
@@ -5546,6 +5865,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "internal";
         }
         /**
@@ -5701,6 +6029,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "internal_user";
         }
         /**
@@ -5856,6 +6193,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "invitation_email";
         }
         /**
@@ -6019,6 +6365,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "link";
         }
         export interface ListSavedViewsResults {
@@ -6029,6 +6384,14 @@ declare namespace Components {
             hits?: number;
             results?: /* A saved entity view */ SavedViewItem[];
         }
+        /**
+         * Strategy for auto-clearing the changeset when an external update is received.
+         * - `exact`: The inbound value must exactly match the proposed value (deep equality).
+         * - `fuzzy`: The inbound value is compared using the configured fuzzy algorithm.
+         * - `any`: Any update to the attribute clears the changeset, regardless of value.
+         *
+         */
+        export type MatchStrategy = "exact" | "fuzzy" | "any";
         /**
          * Message emil address
          */
@@ -6182,6 +6545,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "message_email_address";
             address?: string;
             send_status?: string;
@@ -6340,6 +6712,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "multiselect" | "checkbox";
             /**
              * controls if the matching of values against the options is case sensitive or not
@@ -6439,6 +6820,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
         } | null;
         /**
          * Numeric input
@@ -6593,6 +6983,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "number";
             /**
              * Optional data type override. When set to 'number', the value is stored as a number instead of a string. Defaults to 'string'.
@@ -6757,6 +7156,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "ordered_list";
         }
         /**
@@ -6912,6 +7320,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "partner_organisation";
         }
         /**
@@ -7067,6 +7484,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "partner_status";
         }
         /**
@@ -7222,6 +7648,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "payment";
         }
         /**
@@ -7377,6 +7812,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "relation_payment_method";
         }
         /**
@@ -7532,6 +7976,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "phone";
         }
         /**
@@ -7687,6 +8140,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "portal_access";
         }
         /**
@@ -7842,6 +8304,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "price_component";
         }
         /**
@@ -7997,6 +8468,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "purpose";
         }
         /**
@@ -8167,6 +8647,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval" | "list-view";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "relation";
             relation_type?: "has_many" | "has_one";
             /**
@@ -8188,7 +8677,6 @@ declare namespace Components {
              * When enable_relation_picker is set to true the user will be able to pick existing relations as values. Otherwise, the user will need to create new relation to link.
              */
             enable_relation_picker?: boolean;
-            edit_mode?: "list-view";
             /**
              * Enables the preview, edition, and creation of relation items on a Master-Details view mode.
              */
@@ -8362,6 +8850,15 @@ declare namespace Components {
              * Manifest ID used to create/update the entity
              */
             _manifest?: string /* uuid */[] | null;
+            /**
+             * Pending attribute changesets for attributes configured with external or approval edit mode.
+             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
+             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             */
+            _changesets?: {
+                [name: string]: /* A pending proposed change for a single entity attribute, awaiting external confirmation or human approval. */ Changeset;
+            } | null;
             $relation?: RelationItem;
         }
         export interface RelationItem {
@@ -8536,6 +9033,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
         }
         /**
          * A saved entity view
@@ -8932,10 +9438,14 @@ declare namespace Components {
         export interface SearchMappings {
             [name: string]: {
                 index?: boolean;
-                type?: "keyword" | "text" | "boolean" | "integer" | "long" | "float" | "date" | "flattened" | "nested";
+                type?: "keyword" | "text" | "boolean" | "integer" | "long" | "float" | "date" | "flattened" | "nested" | "object";
                 fields?: {
                     [name: string]: any;
                 };
+                /**
+                 * When false, prevents ES from inferring types for nested fields. Used for _changesets where values can be any type.
+                 */
+                dynamic?: boolean;
             };
         }
         /**
@@ -9091,6 +9601,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "select" | "radio";
             options?: ({
                 value: string;
@@ -9254,6 +9773,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "sequence";
             /**
              * Prefix added before the sequence number
@@ -9426,6 +9954,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "status";
             options?: ((string | null) | {
                 /**
@@ -9677,6 +10214,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "table";
             /**
              * Column definitions for the table
@@ -9702,15 +10248,38 @@ declare namespace Components {
                  * Whether this column is required for each row
                  */
                 required?: boolean;
+                /**
+                 * When true, the row is rendered in bold (only applies in transposed mode)
+                 */
+                bold?: boolean;
             }[];
             /**
              * Minimum number of rows required
              */
             min_rows?: number;
             /**
-             * Maximum number of rows allowed
+             * Maximum number of rows allowed (or maximum periods when transposed)
              */
             max_rows?: number;
+            /**
+             * Enable transposed layout where rows become metrics and columns become periods
+             */
+            transposed?: boolean;
+            /**
+             * Configuration for column headers in transposed mode
+             */
+            column_header?: {
+                /**
+                 * Header label pattern with {{i}} as index placeholder (e.g., "Year {{i}}")
+                 * example:
+                 * Year {{i}}
+                 */
+                template?: string;
+                /**
+                 * Starting index value for the template placeholder
+                 */
+                start?: number;
+            };
         }
         /**
          * Tags
@@ -9865,6 +10434,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "tags";
             options?: string[];
             suggestions?: string[];
@@ -10222,6 +10800,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "string";
             multiline?: boolean;
             rich_text?: boolean;
@@ -10390,6 +10977,15 @@ declare namespace Components {
              */
             repeatable?: boolean;
             has_primary?: boolean;
+            /**
+             * Controls how updates to this attribute are handled.
+             * - `direct` (default): update is applied immediately. No changeset created.
+             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
+             * - `approval`: update creates a changeset, requires explicit human approval.
+             *
+             */
+            edit_mode?: "direct" | "external" | "approval";
+            edit_mode_config?: /* Configuration for non-direct edit modes on an entity attribute. */ EditModeConfig;
             type: "relation_user";
             multiple?: boolean;
         }
@@ -10435,6 +11031,81 @@ declare namespace Paths {
             Components.Responses.NotFoundError;
         }
     }
+    namespace ApplyChangeset {
+        namespace Parameters {
+            export type Attribute = string;
+            export type Id = Components.Schemas.EntityId /* uuid */;
+            export type Slug = /**
+             * URL-friendly identifier for the entity schema
+             * example:
+             * contact
+             */
+            Components.Schemas.EntitySlug /* ^[a-zA-Z0-9_-]+$ */;
+        }
+        export interface PathParameters {
+            slug: Parameters.Slug;
+            id: Parameters.Id;
+            attribute: Parameters.Attribute;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * example:
+             * {
+             *   "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
+             *   "_org": "123",
+             *   "_owners": [
+             *     {
+             *       "org_id": "123",
+             *       "user_id": "123"
+             *     },
+             *     {
+             *       "org_id": "123",
+             *       "user_id": "123"
+             *     }
+             *   ],
+             *   "_schema": "contact",
+             *   "_tags": [
+             *     "example",
+             *     "mock",
+             *     "example",
+             *     "mock"
+             *   ],
+             *   "_created_at": "2021-02-09T12:41:43.662Z",
+             *   "_updated_at": "2021-02-09T12:41:43.662Z",
+             *   "_acl": {
+             *     "view": [
+             *       "org:456",
+             *       "org:789",
+             *       "org:456",
+             *       "org:789"
+             *     ],
+             *     "edit": [
+             *       "org:456",
+             *       "org:456"
+             *     ],
+             *     "delete": [
+             *       "org:456",
+             *       "org:456"
+             *     ]
+             *   },
+             *   "_manifest": [
+             *     "123e4567-e89b-12d3-a456-426614174000",
+             *     "123e4567-e89b-12d3-a456-426614174000"
+             *   ]
+             * }
+             */
+            Components.Schemas.EntityItem;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace AttachActivity {
         namespace Parameters {
             export type Entities = Components.Schemas.EntityId /* uuid */[];
@@ -11201,6 +11872,87 @@ declare namespace Paths {
             Components.Responses.TooManyRequestsError;
         }
     }
+    namespace DismissChangeset {
+        namespace Parameters {
+            export type Attribute = string;
+            export type Id = Components.Schemas.EntityId /* uuid */;
+            export type Slug = /**
+             * URL-friendly identifier for the entity schema
+             * example:
+             * contact
+             */
+            Components.Schemas.EntitySlug /* ^[a-zA-Z0-9_-]+$ */;
+        }
+        export interface PathParameters {
+            slug: Parameters.Slug;
+            id: Parameters.Id;
+            attribute: Parameters.Attribute;
+        }
+        export interface RequestBody {
+            /**
+             * Optional reason for dismissing the changeset
+             */
+            reason?: string;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * example:
+             * {
+             *   "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
+             *   "_org": "123",
+             *   "_owners": [
+             *     {
+             *       "org_id": "123",
+             *       "user_id": "123"
+             *     },
+             *     {
+             *       "org_id": "123",
+             *       "user_id": "123"
+             *     }
+             *   ],
+             *   "_schema": "contact",
+             *   "_tags": [
+             *     "example",
+             *     "mock",
+             *     "example",
+             *     "mock"
+             *   ],
+             *   "_created_at": "2021-02-09T12:41:43.662Z",
+             *   "_updated_at": "2021-02-09T12:41:43.662Z",
+             *   "_acl": {
+             *     "view": [
+             *       "org:456",
+             *       "org:789",
+             *       "org:456",
+             *       "org:789"
+             *     ],
+             *     "edit": [
+             *       "org:456",
+             *       "org:456"
+             *     ],
+             *     "delete": [
+             *       "org:456",
+             *       "org:456"
+             *     ]
+             *   },
+             *   "_manifest": [
+             *     "123e4567-e89b-12d3-a456-426614174000",
+             *     "123e4567-e89b-12d3-a456-426614174000"
+             *   ]
+             * }
+             */
+            Components.Schemas.EntityItem;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace ExportEntities {
         namespace Parameters {
             export type IsTemplate = /* Pass 'true' to generate import template */ Components.Schemas.IsTemplate;
@@ -11508,6 +12260,7 @@ declare namespace Paths {
     }
     namespace GetEntityV2 {
         namespace Parameters {
+            export type ApplyChangesets = boolean;
             export type Fields = /**
              * List of entity fields to include or exclude in the response
              *
@@ -11542,6 +12295,7 @@ declare namespace Paths {
         export interface QueryParameters {
             hydrate?: Parameters.Hydrate;
             fields?: Parameters.Fields;
+            apply_changesets?: Parameters.ApplyChangesets;
         }
         namespace Responses {
             export type $200 = /**
@@ -12446,7 +13200,7 @@ declare namespace Paths {
             /**
              * ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).
              * example:
-             * 2023-01-01T00:00:00.000Z
+             * 2023-01-01T00:00:00Z
              */
             export type CreatedAfter = string; // date-time
             /**
@@ -12472,7 +13226,7 @@ declare namespace Paths {
             created_after?: /**
              * ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).
              * example:
-             * 2023-01-01T00:00:00.000Z
+             * 2023-01-01T00:00:00Z
              */
             Parameters.CreatedAfter /* date-time */;
             sort_pending_first?: /* When true, sorts PENDING status jobs to the top of the results. */ Parameters.SortPendingFirst;
@@ -12559,6 +13313,33 @@ declare namespace Paths {
             }
         }
     }
+    namespace ListChangesets {
+        namespace Parameters {
+            export type Id = Components.Schemas.EntityId /* uuid */;
+            export type Slug = /**
+             * URL-friendly identifier for the entity schema
+             * example:
+             * contact
+             */
+            Components.Schemas.EntitySlug /* ^[a-zA-Z0-9_-]+$ */;
+        }
+        export interface PathParameters {
+            slug: Parameters.Slug;
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = /* Map of attribute name to pending changeset. At most one changeset per attribute. */ Components.Schemas.ChangesetMap;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace ListEntities {
         export type RequestBody = Components.Schemas.EntityListParams;
         namespace Responses {
@@ -12719,6 +13500,7 @@ declare namespace Paths {
              */
             Components.Schemas.ActivityId /* ulid ^01[0-9a-zA-Z]{24}$ */ | ("" | null);
             export type Async = boolean;
+            export type Direct = boolean;
             export type DryRun = boolean;
             export type FillActivity = boolean;
             export type Id = Components.Schemas.EntityId /* uuid */;
@@ -12740,6 +13522,7 @@ declare namespace Paths {
             dry_run?: Parameters.DryRun;
             async?: Parameters.Async;
             validate?: Parameters.Validate;
+            direct?: Parameters.Direct;
         }
         export type RequestBody = /**
          * example:
@@ -13367,6 +14150,7 @@ declare namespace Paths {
              */
             Components.Schemas.ActivityId /* ulid ^01[0-9a-zA-Z]{24}$ */ | ("" | null);
             export type Async = boolean;
+            export type Direct = boolean;
             export type FillActivity = boolean;
             export type Id = Components.Schemas.EntityId /* uuid */;
             export type Slug = /**
@@ -13386,6 +14170,7 @@ declare namespace Paths {
             fill_activity?: Parameters.FillActivity;
             async?: Parameters.Async;
             validate?: Parameters.Validate;
+            direct?: Parameters.Direct;
         }
         export type RequestBody = /**
          * example:
@@ -14437,6 +15222,7 @@ export interface OperationMethods {
    * 
    * - All activites are published as events on the event bus
    * - Entity mutations are always part of an activity
+   * - When more than 10 entities are passed, the first 10 are attached synchronously and the rest are processed asynchronously to avoid DynamoDB throttling
    * 
    */
   'createActivity'(
@@ -14464,6 +15250,39 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.AttachActivity.Responses.$200>
+  /**
+   * applyChangeset - applyChangeset
+   * 
+   * Applies the proposed value from a pending changeset to the entity attribute
+   * and removes the changeset. Used for human approval of pending changes.
+   * 
+   */
+  'applyChangeset'(
+    parameters?: Parameters<Paths.ApplyChangeset.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ApplyChangeset.Responses.$200>
+  /**
+   * dismissChangeset - dismissChangeset
+   * 
+   * Removes a pending changeset without applying it. The attribute value remains unchanged.
+   * 
+   */
+  'dismissChangeset'(
+    parameters?: Parameters<Paths.DismissChangeset.PathParameters> | null,
+    data?: Paths.DismissChangeset.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DismissChangeset.Responses.$200>
+  /**
+   * listChangesets - listChangesets
+   * 
+   * Returns all pending changesets for an entity.
+   */
+  'listChangesets'(
+    parameters?: Parameters<Paths.ListChangesets.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListChangesets.Responses.$200>
   /**
    * getEntityActivityFeed - getEntityActivityFeed
    * 
@@ -15627,6 +16446,7 @@ export interface PathsDictionary {
      * 
      * - All activites are published as events on the event bus
      * - Entity mutations are always part of an activity
+     * - When more than 10 entities are passed, the first 10 are attached synchronously and the rest are processed asynchronously to avoid DynamoDB throttling
      * 
      */
     'post'(
@@ -15659,6 +16479,45 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.AttachActivity.Responses.$200>
   }
+  ['/v1/entity/{slug}/{id}/changesets/{attribute}:apply']: {
+    /**
+     * applyChangeset - applyChangeset
+     * 
+     * Applies the proposed value from a pending changeset to the entity attribute
+     * and removes the changeset. Used for human approval of pending changes.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.ApplyChangeset.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ApplyChangeset.Responses.$200>
+  }
+  ['/v1/entity/{slug}/{id}/changesets/{attribute}:dismiss']: {
+    /**
+     * dismissChangeset - dismissChangeset
+     * 
+     * Removes a pending changeset without applying it. The attribute value remains unchanged.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.DismissChangeset.PathParameters> | null,
+      data?: Paths.DismissChangeset.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DismissChangeset.Responses.$200>
+  }
+  ['/v1/entity/{slug}/{id}/changesets']: {
+    /**
+     * listChangesets - listChangesets
+     * 
+     * Returns all pending changesets for an entity.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListChangesets.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListChangesets.Responses.$200>
+  }
   ['/v1/entity/{slug}/{id}/activity']: {
     /**
      * getEntityActivityFeed - getEntityActivityFeed
@@ -16319,6 +17178,9 @@ export type BaseAttribute = Components.Schemas.BaseAttribute;
 export type BaseEntity = Components.Schemas.BaseEntity;
 export type BlueprintEntityId = Components.Schemas.BlueprintEntityId;
 export type BooleanAttribute = Components.Schemas.BooleanAttribute;
+export type Changeset = Components.Schemas.Changeset;
+export type ChangesetCreator = Components.Schemas.ChangesetCreator;
+export type ChangesetMap = Components.Schemas.ChangesetMap;
 export type ClassificationId = Components.Schemas.ClassificationId;
 export type ClassificationIdOrPattern = Components.Schemas.ClassificationIdOrPattern;
 export type ClassificationSlug = Components.Schemas.ClassificationSlug;
@@ -16330,6 +17192,7 @@ export type CurrencyAttribute = Components.Schemas.CurrencyAttribute;
 export type DateAttribute = Components.Schemas.DateAttribute;
 export type DefaultAddressFields = Components.Schemas.DefaultAddressFields;
 export type ESClusterAssignment = Components.Schemas.ESClusterAssignment;
+export type EditModeConfig = Components.Schemas.EditModeConfig;
 export type EmailAttribute = Components.Schemas.EmailAttribute;
 export type Entity = Components.Schemas.Entity;
 export type EntityAcl = Components.Schemas.EntityAcl;
@@ -16369,6 +17232,7 @@ export type ErrorObject = Components.Schemas.ErrorObject;
 export type ExportJobId = Components.Schemas.ExportJobId;
 export type FieldsParam = Components.Schemas.FieldsParam;
 export type FileAttribute = Components.Schemas.FileAttribute;
+export type FuzzyConfig = Components.Schemas.FuzzyConfig;
 export type GenerateEntityTableAIFiltersRequest = Components.Schemas.GenerateEntityTableAIFiltersRequest;
 export type GenerateEntityTableAIFiltersResponse = Components.Schemas.GenerateEntityTableAIFiltersResponse;
 export type GetRelatedEntitiesCount = Components.Schemas.GetRelatedEntitiesCount;
@@ -16391,6 +17255,7 @@ export type IsTemplate = Components.Schemas.IsTemplate;
 export type Language = Components.Schemas.Language;
 export type LinkAttribute = Components.Schemas.LinkAttribute;
 export type ListSavedViewsResults = Components.Schemas.ListSavedViewsResults;
+export type MatchStrategy = Components.Schemas.MatchStrategy;
 export type MessageEmailAddressAttribute = Components.Schemas.MessageEmailAddressAttribute;
 export type MultiSelectAttribute = Components.Schemas.MultiSelectAttribute;
 export type NullableEntity = Components.Schemas.NullableEntity;