@uipath/uipath-typescript 1.3.11 → 1.4.1

package/dist/entities/index.d.ts

@@ -107,6 +107,7 @@ interface RequestWithPaginationOptions extends RequestSpec {
             tokenParam?: string;
             countParam?: string;
             convertToSkip?: boolean;
+            zeroBased?: boolean;
         };
     };
 }
@@ -299,6 +300,24 @@ declare class BaseService {
     private determineHasMorePages;
 }
 
+/**
+ * Shared types for the Data Fabric domain — used by both Entities and ChoiceSets.
+ * Lives here (not in either service's `*.types.ts`) to avoid cross-domain coupling
+ * between sibling services.
+ */
+/**
+ * Common shape for every folder-scoped Data Fabric operation.
+ * Forwarded on the wire as the `X-UIPATH-FolderKey` header.
+ */
+interface EntityFolderScopedOptions {
+    /**
+     * Key identifying the folder the entity belongs to. Omit for tenant-level entities.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    folderKey?: string;
+}
+
 /**
  * Entity field data type names (SQL-level types returned by the API)
  */
@@ -341,7 +360,7 @@ interface EntityRecord {
 type EntityGetRecordsByIdOptions = {
     /** Level of entity expansion (default: 0) */
     expansionLevel?: number;
-} & PaginationOptions;
+} & PaginationOptions & EntityFolderScopedOptions;
 /**
  * Options for getting all records of an entity
  */
@@ -349,14 +368,14 @@ type EntityGetAllRecordsOptions = EntityGetRecordsByIdOptions;
 /**
  * Options for getting a single entity record by entity ID and record ID
  */
-interface EntityGetRecordByIdOptions {
+interface EntityGetRecordByIdOptions extends EntityFolderScopedOptions {
     /** Level of entity expansion (default: 0) */
     expansionLevel?: number;
 }
 /**
  * Common options for entity operations that modify multiple records
  */
-interface EntityOperationOptions {
+interface EntityOperationOptions extends EntityFolderScopedOptions {
     /** Level of entity expansion (default: 0) */
     expansionLevel?: number;
     /** Whether to fail on first error (default: false) */
@@ -366,7 +385,7 @@ interface EntityOperationOptions {
  * Options for inserting a single record into an entity
  * @deprecated Use {@link EntityInsertRecordOptions} instead for better clarity on inserting a single record into an entity. This type will be removed in future versions.
  */
-interface EntityInsertOptions {
+interface EntityInsertOptions extends EntityFolderScopedOptions {
     /** Level of entity expansion (default: 0) */
     expansionLevel?: number;
 }
@@ -406,7 +425,7 @@ interface EntityUpdateRecordsOptions extends EntityOperationOptions {
  * Options for deleting data from an entity
  * @deprecated Use {@link EntityDeleteRecordsOptions} instead for better clarity on deleting records from an entity. This type will be removed in future versions.
  */
-interface EntityDeleteOptions {
+interface EntityDeleteOptions extends EntityFolderScopedOptions {
     /** Whether to fail on first error (default: false) */
     failOnFirst?: boolean;
 }
@@ -415,6 +434,10 @@ interface EntityDeleteOptions {
  */
 interface EntityDeleteRecordsOptions extends EntityDeleteOptions {
 }
+interface EntityDeleteRecordByIdOptions extends EntityFolderScopedOptions {
+}
+interface EntityImportRecordsByIdOptions extends EntityFolderScopedOptions {
+}
 /**
  * Logical operator for combining query filter groups
  */
@@ -523,7 +546,7 @@ type EntityQueryRecordsOptions = {
     aggregates?: EntityAggregate[];
     /** Field names to group aggregate results by. */
     groupBy?: string[];
-} & PaginationOptions;
+} & PaginationOptions & EntityFolderScopedOptions;
 /**
  * Response from querying entity records
  */
@@ -579,17 +602,35 @@ interface EntityCreateFieldOptions extends EntityFieldBase {
     referenceEntityId?: string;
     /** UUID of the referenced field on the target entity (required when `type` is `RELATIONSHIP` or `FILE`) */
     referenceFieldId?: string;
+    /**
+     * Folder key of the reference target when it lives outside the source's folder. Pass `'00000000-0000-0000-0000-000000000000'` for tenant-level system targets.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    referenceFolderKey?: string;
+}
+interface EntityGetAllOptions extends EntityFolderScopedOptions {
+    /**
+     * When `true`, returns tenant-level and folder-level entities together.
+     * Omit (or `false`, the default) to return only tenant-level entities.
+     * Ignored when `folderKey` is provided — `folderKey` is preferred over `includeFolderEntities` when both are set.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    includeFolderEntities?: boolean;
+}
+interface EntityGetByIdOptions extends EntityFolderScopedOptions {
+}
+interface EntityDeleteByIdOptions extends EntityFolderScopedOptions {
 }
 /**
  * Options for creating a new Data Fabric entity
  */
-interface EntityCreateOptions {
+interface EntityCreateOptions extends EntityFolderScopedOptions {
     /** Human-readable display name shown in the UI (defaults to `name` if omitted) */
     displayName?: string;
     /** Optional entity description */
     description?: string;
-    /** UUID of the folder to place the entity in (defaults to the tenant-level folder) */
-    folderKey?: string;
     /** Whether role-based access control is enabled for this entity (default: false) */
     isRbacEnabled?: boolean;
     /** Whether Analytics integration is enabled for this entity (default: false) */
@@ -618,7 +659,7 @@ interface EntityRemoveFieldOptions {
  * (`displayName`, `description`, `isRbacEnabled`) can be combined; each is applied
  * only when the corresponding fields are provided.
  */
-interface EntityUpdateByIdOptions {
+interface EntityUpdateByIdOptions extends EntityFolderScopedOptions {
     /** New fields to add */
     addFields?: EntityCreateFieldOptions[];
     /** Fields to remove, each identified by field name */
@@ -650,10 +691,20 @@ type EntityFileType = Blob | File | Uint8Array;
 /**
  * Optional options for uploading an attachment to an entity record
  */
-interface EntityUploadAttachmentOptions {
+interface EntityUploadAttachmentOptions extends EntityFolderScopedOptions {
     /** Optional expansion level (default: 0) */
     expansionLevel?: number;
 }
+/**
+ * Optional options for downloading an attachment from an entity record
+ */
+interface EntityDownloadAttachmentOptions extends EntityFolderScopedOptions {
+}
+/**
+ * Optional options for deleting an attachment from an entity record
+ */
+interface EntityDeleteAttachmentOptions extends EntityFolderScopedOptions {
+}
 /**
  * Response from uploading an attachment to an entity record
  */
@@ -914,23 +965,35 @@ interface RawEntityGetResponse {
  */
 interface EntityServiceModel {
     /**
-     * Gets all entities in the system
+     * Gets entities in the tenant.
      *
-     * @returns Promise resolving to either an array of entities NonPaginatedResponse<EntityGetResponse> or a PaginatedResponse<EntityGetResponse> when pagination options are used.
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level entities.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only entities in that folder.
+     * - `getAll({ includeFolderEntities: true })` — returns tenant-level **and** folder-level entities together. `folderKey` is preferred over `includeFolderEntities` when both are set.
+     *
+     * @param options - Optional {@link EntityGetAllOptions} (`folderKey` to list a single folder's entities — preferred when scoping to a folder; `includeFolderEntities: true` to list tenant + folder entities together) The `folderKey` property is **experimental**.
+     * @returns Promise resolving to an array of entity metadata
      * {@link EntityGetResponse}
      * @example
      * ```typescript
-     * // Get all entities
-     * const allEntities = await entities.getAll();
+     * // Tenant-only (default)
+     * const tenantEntities = await entities.getAll();
+     *
+     * // A single folder's entities (preferred when targeting a specific folder)
+     * const folderEntities = await entities.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder entities together
+     * const allEntities = await entities.getAll({ includeFolderEntities: true });
      *
      * // Iterate through entities
-     * allEntities.forEach(entity => {
+     * tenantEntities.forEach(entity => {
      *   console.log(`Entity: ${entity.displayName} (${entity.name})`);
      *   console.log(`Type: ${entity.entityType}`);
      * });
      *
      * // Find a specific entity by name
-     * const customerEntity = allEntities.find(e => e.name === 'Customer');
+     * const customerEntity = tenantEntities.find(e => e.name === 'Customer');
      *
      * // Use entity methods directly
      * if (customerEntity) {
@@ -948,11 +1011,12 @@ interface EntityServiceModel {
      * }
      * ```
      */
-    getAll(): Promise<EntityGetResponse[]>;
+    getAll(options?: EntityGetAllOptions): Promise<EntityGetResponse[]>;
     /**
      * Gets entity metadata by entity ID with attached operation methods
      *
      * @param id - UUID of the entity
+     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to entity metadata with operation methods
      * {@link EntityGetResponse}
      * @example
@@ -965,6 +1029,9 @@ interface EntityServiceModel {
      * // Get entity metadata with methods
      * const entity = await entities.getById("<entityId>");
      *
+     * // Folder-scoped: pass the entity's folder key
+     * const folderEntity = await entities.getById("<entityId>", { folderKey: "<folderKey>" });
+     *
      * // Call operations directly on the entity
      * const records = await entity.getAllRecords();
      *
@@ -984,12 +1051,12 @@ interface EntityServiceModel {
      * ]);
      * ```
      */
-    getById(id: string): Promise<EntityGetResponse>;
+    getById(id: string, options?: EntityGetByIdOptions): Promise<EntityGetResponse>;
     /**
      * Gets entity records by entity ID
      *
      * @param entityId - UUID of the entity
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to either an array of entity records NonPaginatedResponse<EntityRecord> or a PaginatedResponse<EntityRecord> when pagination options are used.
      * {@link EntityRecord}
      * @example
@@ -1013,6 +1080,9 @@ interface EntityServiceModel {
      *   cursor: paginatedResponse.nextCursor,
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const records = await entities.getAllRecords("<entityId>", { folderKey: "<folderKey>" });
      * ```
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(entityId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1026,7 +1096,7 @@ interface EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to a single entity record
      * {@link EntityRecord}
      * @example
@@ -1042,6 +1112,11 @@ interface EntityServiceModel {
      * const record = await entities.getRecordById(<entityId>, recordId, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const record = await entities.getRecordById(<entityId>, recordId, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     getRecordById(entityId: string, recordId: string, options?: EntityGetRecordByIdOptions): Promise<EntityRecord>;
@@ -1053,7 +1128,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Record to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted record with generated record ID
      * {@link EntityInsertResponse}
      * @example
@@ -1065,6 +1140,11 @@ interface EntityServiceModel {
      * const result = await entities.insertRecordById(<entityId>, { name: "John", age: 30 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordById(<entityId>, { name: "John", age: 30 }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     insertRecordById(id: string, data: Record<string, any>, options?: EntityInsertRecordOptions): Promise<EntityInsertResponse>;
@@ -1081,7 +1161,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Array of records to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to insert response
      * {@link EntityBatchInsertResponse}
      * @example
@@ -1100,6 +1180,12 @@ interface EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordsById(<entityId>, [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     insertRecordsById(id: string, data: Record<string, any>[], options?: EntityInsertRecordsOptions): Promise<EntityBatchInsertResponse>;
@@ -1117,7 +1203,7 @@ interface EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to update
      * @param data - Key-value pairs of fields to update
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated record
      * {@link EntityUpdateRecordResponse}
      * @example
@@ -1129,6 +1215,11 @@ interface EntityServiceModel {
      * const result = await entities.updateRecordById(<entityId>, <recordId>, { name: "John Updated", age: 31 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordById(<entityId>, <recordId>, { name: "John Updated" }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     updateRecordById(entityId: string, recordId: string, data: Record<string, any>, options?: EntityUpdateRecordOptions): Promise<EntityUpdateRecordResponse>;
@@ -1139,7 +1230,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Array of records to update. Each record MUST contain the record id.
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to update response
      * {@link EntityUpdateResponse}
      * @example
@@ -1158,6 +1249,11 @@ interface EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordsById(<entityId>, [
+     *   { Id: "123", name: "John Updated" }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     updateRecordsById(id: string, data: EntityRecord[], options?: EntityUpdateRecordsOptions): Promise<EntityUpdateResponse>;
@@ -1168,7 +1264,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param recordIds - Array of record UUIDs to delete
-     * @param options - Delete options
+     * @param options - Delete options The `folderKey` property is **experimental**.
      * @returns Promise resolving to delete response
      * {@link EntityDeleteResponse}
      * @example
@@ -1177,6 +1273,11 @@ interface EntityServiceModel {
      * const result = await entities.deleteRecordsById(<entityId>, [
      *   <recordId-1>, <recordId-2>
      * ]);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.deleteRecordsById(<entityId>, [
+     *   <recordId-1>, <recordId-2>
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     deleteRecordsById(id: string, recordIds: string[], options?: EntityDeleteRecordsOptions): Promise<EntityDeleteResponse>;
@@ -1188,6 +1289,7 @@ interface EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to delete
+     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to void on success
      * @example
      * ```typescript
@@ -1196,14 +1298,17 @@ interface EntityServiceModel {
      * const entities = new Entities(sdk);
      *
      * await entities.deleteRecordById("<entityId>", "<recordId>");
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * await entities.deleteRecordById("<entityId>", "<recordId>", { folderKey: "<folderKey>" });
      * ```
      */
-    deleteRecordById(entityId: string, recordId: string): Promise<void>;
+    deleteRecordById(entityId: string, recordId: string, options?: EntityDeleteRecordByIdOptions): Promise<void>;
     /**
      * Queries entity records with filters, sorting, aggregates, and SDK-managed pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      * @example
@@ -1237,6 +1342,12 @@ interface EntityServiceModel {
      *   ],
      * });
      *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.queryRecordsById(<id>, {
+     *   filterGroup: { queryFilters: [{ fieldName: "status", operator: QueryFilterOperator.Equals, value: "active" }] },
+     *   folderKey: "<folderKey>",
+     * });
+     *
      * // Aggregate: total sum and average across all records (no grouping)
      * await entities.queryRecordsById(<id>, {
      *   aggregates: [
@@ -1252,6 +1363,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param file - CSV file to import as a Blob or File or Uint8Array
+     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityImportRecordsResponse} with record counts
      * @example
      * ```typescript
@@ -1259,16 +1371,19 @@ interface EntityServiceModel {
      * const fileInput = document.getElementById('csv-input') as HTMLInputElement;
      * const result = await entities.importRecordsById(<id>, fileInput.files[0]);
      * console.log(`Inserted ${result.insertedRecords} of ${result.totalRecords} records`);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.importRecordsById(<id>, fileInput.files[0], { folderKey: "<folderKey>" });
      * ```
-     * @internal
      */
-    importRecordsById(id: string, file: EntityFileType): Promise<EntityImportRecordsResponse>;
+    importRecordsById(id: string, file: EntityFileType, options?: EntityImportRecordsByIdOptions): Promise<EntityImportRecordsResponse>;
     /**
      * Downloads an attachment stored in a File-type field of an entity record.
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      * @example
      * ```typescript
@@ -1315,7 +1430,7 @@ interface EntityServiceModel {
      * fs.writeFileSync('attachment.pdf', buffer);
      * ```
      */
-    downloadAttachment(entityId: string, recordId: string, fieldName: string): Promise<Blob>;
+    downloadAttachment(entityId: string, recordId: string, fieldName: string, options?: EntityDownloadAttachmentOptions): Promise<Blob>;
     /**
      * Uploads an attachment to a File-type field of an entity record.
      *
@@ -1325,7 +1440,7 @@ interface EntityServiceModel {
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      * @example
      * ```typescript
@@ -1346,6 +1461,9 @@ interface EntityServiceModel {
      * const file = fileInput.files[0];
      * const response = await entities.uploadAttachment(entityId, recordId, 'Documents', file);
      *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.uploadAttachment(entityId, recordId, 'Documents', file, { folderKey: "<folderKey>" });
+     *
      * // Node.js: Upload a file from disk
      * const fileBuffer = fs.readFileSync('document.pdf');
      * const blob = new Blob([fileBuffer], { type: 'application/pdf' });
@@ -1359,6 +1477,7 @@ interface EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      * @example
      * ```typescript
@@ -1382,14 +1501,14 @@ interface EntityServiceModel {
      * await entity.deleteAttachment(recordId, 'Documents');
      * ```
      */
-    deleteAttachment(entityId: string, recordId: string, fieldName: string): Promise<EntityDeleteAttachmentResponse>;
+    deleteAttachment(entityId: string, recordId: string, fieldName: string, options?: EntityDeleteAttachmentOptions): Promise<EntityDeleteAttachmentResponse>;
     /**
      * Creates a new Data Fabric entity with the given schema
      *
      * @param name - Entity name — must start with a letter, letters/numbers/underscores only
      *   (e.g., `"productCatalog"`).
      * @param fields - Array of field definitions
-     * @param options - Optional entity-level settings ({@link EntityCreateOptions})
+     * @param options - Optional entity-level settings ({@link EntityCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the ID of the created entity
      * @example
      * ```typescript
@@ -1408,6 +1527,24 @@ interface EntityServiceModel {
      *   { fieldName: "price", type: EntityFieldDataType.DECIMAL, decimalPrecision: 4, maxValue: 999999, minValue: 0 },
      *   { fieldName: "quantity", type: EntityFieldDataType.INTEGER, maxValue: 10000, minValue: 1, defaultValue: "0" },
      * ]);
+     *
+     * // Cross-folder references — link a folder-scoped entity to entities and
+     * // system choice sets that live in another folder or at the tenant level.
+     * await entities.create("orderLine", [
+     *   {
+     *     fieldName: "order",
+     *     type: EntityFieldDataType.RELATIONSHIP,
+     *     referenceEntityId: "<orderEntityId>",
+     *     referenceFieldId: "<orderEntityPkId>",
+     *     referenceFolderKey: "<otherFolderKey>",     // target lives in a different folder
+     *   },
+     *   {
+     *     fieldName: "userType",
+     *     type: EntityFieldDataType.CHOICE_SET_SINGLE,
+     *     choiceSetId: "<systemUserTypeChoiceSetId>", // tenant-level system choice set
+     *     // referenceFolderKey omitted → SDK looks up the target at tenant scope
+     *   },
+     * ], { folderKey: "<sourceFolderKey>" });
      * ```
      * @internal
      */
@@ -1416,14 +1553,18 @@ interface EntityServiceModel {
      * Deletes a Data Fabric entity and all its records
      *
      * @param id - UUID of the entity to delete
+     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the entity is deleted
      * @example
      * ```typescript
      * await entities.deleteById(<id>);
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * await entities.deleteById(<id>, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(id: string): Promise<void>;
+    deleteById(id: string, options?: EntityDeleteByIdOptions): Promise<void>;
     /**
      * Updates an existing Data Fabric entity — schema and/or metadata.
      *
@@ -1432,8 +1573,7 @@ interface EntityServiceModel {
      * only when the corresponding fields are provided.
      *
      * @param id - UUID of the entity to update
-     * @param name - name of the entity (required by the API)
-     * @param options - Changes to apply ({@link EntityUpdateByIdOptions})
+     * @param options - Changes to apply ({@link EntityUpdateByIdOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -1466,6 +1606,12 @@ interface EntityServiceModel {
      *     { id: <fieldId>, lengthLimit: 1000 },
      *   ],
      * });
+     *
+     * // Folder-scoped entity: add a field to an entity that lives in a non-tenant folder
+     * await entities.updateById(<id>, {
+     *   folderKey: "<folderKey>",
+     *   addFields: [{ fieldName: "notes", type: EntityFieldDataType.MULTILINE_TEXT }],
+     * });
      * ```
      * @internal
      */
@@ -1538,13 +1684,14 @@ interface EntityMethods {
      * Use this method if you need trigger events to fire for the deleted record.
      *
      * @param recordId - UUID of the record to delete
+     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities)
      * @returns Promise resolving to void on success
      */
-    deleteRecord(recordId: string): Promise<void>;
+    deleteRecord(recordId: string, options?: EntityDeleteRecordByIdOptions): Promise<void>;
     /**
      * Get all records from this entity
      *
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to query response
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1561,16 +1708,17 @@ interface EntityMethods {
      *
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      */
-    downloadAttachment(recordId: string, fieldName: string): Promise<Blob>;
+    downloadAttachment(recordId: string, fieldName: string, options?: EntityDownloadAttachmentOptions): Promise<Blob>;
     /**
      * Uploads an attachment to a File-type field of an entity record
      *
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel, folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      */
     uploadAttachment(recordId: string, fieldName: string, file: EntityFileType, options?: EntityUploadAttachmentOptions): Promise<EntityUploadAttachmentResponse>;
@@ -1579,9 +1727,10 @@ interface EntityMethods {
      *
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      */
-    deleteAttachment(recordId: string, fieldName: string): Promise<EntityDeleteAttachmentResponse>;
+    deleteAttachment(recordId: string, fieldName: string, options?: EntityDeleteAttachmentOptions): Promise<EntityDeleteAttachmentResponse>;
     /**
      * @deprecated Use {@link insertRecord} instead.
      * @hidden
@@ -1637,6 +1786,7 @@ interface EntityMethods {
      * Imports records from a CSV file into this entity
      *
      * @param file - CSV file to import as a Blob, File, or Uint8Array
+     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities)
      * @returns Promise resolving to {@link EntityImportRecordsResponse} with record counts
      * @example
      * ```typescript
@@ -1644,9 +1794,12 @@ interface EntityMethods {
      * const fileInput = document.getElementById('csv-input') as HTMLInputElement;
      * const result = await entity.importRecords(fileInput.files[0]);
      * console.log(`Inserted ${result.insertedRecords} of ${result.totalRecords} records`);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entity.importRecords(fileInput.files[0], { folderKey: "<folderKey>" });
      * ```
      */
-    importRecords(file: EntityFileType): Promise<EntityImportRecordsResponse>;
+    importRecords(file: EntityFileType, options?: EntityImportRecordsByIdOptions): Promise<EntityImportRecordsResponse>;
     /**
      * @deprecated Use {@link getAllRecords} instead.
      * @hidden
@@ -1655,15 +1808,19 @@ interface EntityMethods {
     /**
      * Deletes this entity and all its records
      *
+     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities)
      * @returns Promise resolving when the entity is deleted
      * @example
      * ```typescript
      * const entity = await entities.getById(<id>);
      * await entity.delete();
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entity.delete({ folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    delete(): Promise<void>;
+    delete(options?: EntityDeleteByIdOptions): Promise<void>;
     /**
      * Updates this entity — schema and/or metadata.
      *
@@ -1710,6 +1867,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * Gets entity metadata by entity ID with attached operation methods
      *
      * @param id - UUID of the entity
+     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to entity metadata with schema information and operation methods
      *
      * @example
@@ -1719,6 +1877,9 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const entities = new Entities(sdk);
      * const entity = await entities.getById("<entityId>");
      *
+     * // Folder-scoped: pass the entity's folder key
+     * const folderEntity = await entities.getById("<entityId>", { folderKey: "<folderKey>" });
+     *
      * // Call operations directly on the entity
      * const records = await entity.getAllRecords();
      *
@@ -1732,12 +1893,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * ]);
      * ```
      */
-    getById(id: string): Promise<EntityGetResponse>;
+    getById(id: string, options?: EntityGetByIdOptions): Promise<EntityGetResponse>;
     /**
      * Gets entity records by entity ID
      *
      * @param entityId - UUID of the entity
-     * @param options - Query options including expansionLevel and pagination options
+     * @param options - Query options including expansionLevel and pagination options The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of entity records or paginated response
      *
      * @example
@@ -1765,6 +1926,9 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   cursor: paginatedResponse.nextCursor,
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const records = await entities.getAllRecords("<entityId>", { folderKey: "<folderKey>" });
      * ```
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(entityId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1773,7 +1937,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record
-     * @param options - Query options including expansionLevel
+     * @param options - Query options including `expansionLevel` and `folderKey` The `folderKey` property is **experimental**.
      * @returns Promise resolving to the entity record
      *
      * @example
@@ -1785,6 +1949,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const record = await sdk.entities.getRecordById(<entityId>, <recordId>, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const record = await sdk.entities.getRecordById(<entityId>, <recordId>, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     getRecordById(entityId: string, recordId: string, options?: EntityGetRecordByIdOptions): Promise<EntityRecord>;
@@ -1793,7 +1962,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param data - Record to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted record with generated record ID
      *
      * @example
@@ -1809,6 +1978,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.insertRecordById("<entityId>", { name: "John", age: 30 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordById("<entityId>", { name: "John", age: 30 }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     insertRecordById(id: string, data: Record<string, any>, options?: EntityInsertRecordOptions): Promise<EntityInsertResponse>;
@@ -1817,7 +1991,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param data - Array of records to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to insert response
      *
      * @example
@@ -1840,6 +2014,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordsById("<entityId>", [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     insertRecordsById(id: string, data: Record<string, any>[], options?: EntityInsertRecordsOptions): Promise<EntityBatchInsertResponse>;
@@ -1849,7 +2029,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to update
      * @param data - Key-value pairs of fields to update
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated record
      *
      * @example
@@ -1865,6 +2045,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.updateRecordById("<entityId>", "<recordId>", { name: "John Updated", age: 31 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordById("<entityId>", "<recordId>", { name: "John Updated" }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     updateRecordById(entityId: string, recordId: string, data: Record<string, any>, options?: EntityUpdateRecordOptions): Promise<EntityUpdateRecordResponse>;
@@ -1874,7 +2059,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param data - Array of records to update. Each record MUST contain the record Id,
      *               otherwise the update will fail.
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to update response
      *
      * @example
@@ -1897,6 +2082,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordsById("<entityId>", [
+     *   { Id: "123", name: "John Updated" }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     updateRecordsById(id: string, data: EntityRecord[], options?: EntityUpdateRecordsOptions): Promise<EntityUpdateResponse>;
@@ -1907,7 +2097,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordIds - Array of record UUIDs to delete
-     * @param options - Delete options
+     * @param options - Delete options The `folderKey` property is **experimental**.
      * @returns Promise resolving to delete response
      *
      * @example
@@ -1920,6 +2110,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.deleteRecordsById("<entityId>", [
      *   "<recordId-1>", "<recordId-2>"
      * ]);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.deleteRecordsById("<entityId>", [
+     *   "<recordId-1>", "<recordId-2>"
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     deleteRecordsById(id: string, recordIds: string[], options?: EntityDeleteRecordsOptions): Promise<EntityDeleteResponse>;
@@ -1931,6 +2126,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to delete
+     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to void on success
      * @example
      * ```typescript
@@ -1939,12 +2135,21 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const entities = new Entities(sdk);
      *
      * await entities.deleteRecordById("<entityId>", "<recordId>");
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * await entities.deleteRecordById("<entityId>", "<recordId>", { folderKey: "<folderKey>" });
      * ```
      */
-    deleteRecordById(entityId: string, recordId: string): Promise<void>;
+    deleteRecordById(entityId: string, recordId: string, options?: EntityDeleteRecordByIdOptions): Promise<void>;
     /**
-     * Gets all entities in the system
+     * Gets entities in the tenant.
+     *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level entities.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only entities in that folder.
+     * - `getAll({ includeFolderEntities: true })` — returns tenant-level **and** folder-level entities together. `folderKey` is preferred over `includeFolderEntities` when both are set.
      *
+     * @param options - Optional {@link EntityGetAllOptions} (`folderKey` to list a single folder's entities — preferred when scoping to a folder; `includeFolderEntities: true` to list tenant + folder entities together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of entity metadata
      *
      * @example
@@ -1953,19 +2158,25 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * const entities = new Entities(sdk);
      *
-     * // Get all entities
-     * const allEntities = await entities.getAll();
+     * // Tenant-only (default)
+     * const tenantEntities = await entities.getAll();
+     *
+     * // A single folder's entities (preferred when targeting a specific folder)
+     * const folderEntities = await entities.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder entities together
+     * const allEntities = await entities.getAll({ includeFolderEntities: true });
      *
      * // Call operations on an entity
-     * const records = await allEntities[0].getAllRecords();
+     * const records = await tenantEntities[0].getAllRecords();
      * ```
      */
-    getAll(): Promise<EntityGetResponse[]>;
+    getAll(options?: EntityGetAllOptions): Promise<EntityGetResponse[]>;
     /**
      * Queries entity records with filters, sorting, aggregates, and pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      *
@@ -2012,6 +2223,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
      *   ],
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.queryRecordsById("<entityId>", {
+     *   filterGroup: { queryFilters: [{ fieldName: "status", operator: QueryFilterOperator.Equals, value: "active" }] },
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      */
     queryRecordsById<T extends EntityQueryRecordsOptions = EntityQueryRecordsOptions>(id: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -2020,6 +2237,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param file - CSV file to import (Blob, File, or Uint8Array)
+     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to import result with record counts
      *
      * @example
@@ -2040,16 +2258,19 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * if (result.errorFileLink) {
      *   console.log(`Error file link: ${result.errorFileLink}`);
      * }
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.importRecordsById("<entityId>", fileInput.files[0], { folderKey: "<folderKey>" });
      * ```
-     * @internal
      */
-    importRecordsById(id: string, file: EntityFileType): Promise<EntityImportRecordsResponse>;
+    importRecordsById(id: string, file: EntityFileType, options?: EntityImportRecordsByIdOptions): Promise<EntityImportRecordsResponse>;
     /**
      * Downloads an attachment from an entity record field
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      *
      * @example
@@ -2068,9 +2289,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * // Download attachment for a specific record and field
      * const blob = await entities.downloadAttachment(entityId, recordId, 'Documents');
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * const blob = await entities.downloadAttachment(entityId, recordId, 'Documents', { folderKey: "<folderKey>" });
      * ```
      */
-    downloadAttachment(entityId: string, recordId: string, fieldName: string): Promise<Blob>;
+    downloadAttachment(entityId: string, recordId: string, fieldName: string, options?: EntityDownloadAttachmentOptions): Promise<Blob>;
     /**
      * Uploads an attachment to a File-type field of an entity record
      *
@@ -2078,7 +2302,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      *
      * @example
@@ -2097,6 +2321,9 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * // Upload a file attachment
      * const response = await entities.uploadAttachment(entityId, recordId, 'Documents', file);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.uploadAttachment(entityId, recordId, 'Documents', file, { folderKey: "<folderKey>" });
      * ```
      */
     uploadAttachment(entityId: string, recordId: string, fieldName: string, file: EntityFileType, options?: EntityUploadAttachmentOptions): Promise<EntityUploadAttachmentResponse>;
@@ -2106,6 +2333,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      *
      * @example
@@ -2124,9 +2352,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * // Delete attachment for a specific record and field
      * await entities.deleteAttachment(entityId, recordId, 'Documents');
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * await entities.deleteAttachment(entityId, recordId, 'Documents', { folderKey: "<folderKey>" });
      * ```
      */
-    deleteAttachment(entityId: string, recordId: string, fieldName: string): Promise<EntityDeleteAttachmentResponse>;
+    deleteAttachment(entityId: string, recordId: string, fieldName: string, options?: EntityDeleteAttachmentOptions): Promise<EntityDeleteAttachmentResponse>;
     /**
    * @hidden
    * @deprecated Use {@link getAllRecords} instead.
@@ -2148,7 +2379,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param name - Entity name — must start with a letter and contain
      *   only letters, numbers, and underscores (e.g., `"productCatalog"`).
      * @param fields - Array of field definitions
-     * @param options - Optional entity-level settings ({@link EntityCreateOptions})
+     * @param options - Optional entity-level settings ({@link EntityCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the ID of the created entity
      *
      * @example
@@ -2164,6 +2395,24 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   { fieldName: "price", type: EntityFieldDataType.DECIMAL, decimalPrecision: 4, maxValue: 999999, minValue: 0 },
      *   { fieldName: "quantity", type: EntityFieldDataType.INTEGER, maxValue: 10000, minValue: 1, defaultValue: "0" },
      * ]);
+     *
+     * // Cross-folder references — link a folder-scoped entity to entities and
+     * // system choice sets that live in another folder or at the tenant level.
+     * await entities.create("orderLine", [
+     *   {
+     *     fieldName: "order",
+     *     type: EntityFieldDataType.RELATIONSHIP,
+     *     referenceEntityId: "<orderEntityId>",
+     *     referenceFieldId: "<orderEntityPkId>",
+     *     referenceFolderKey: "<otherFolderKey>",     // target lives in a different folder
+     *   },
+     *   {
+     *     fieldName: "userType",
+     *     type: EntityFieldDataType.CHOICE_SET_SINGLE,
+     *     choiceSetId: "<systemUserTypeChoiceSetId>", // tenant-level system choice set
+     *     // referenceFolderKey omitted → SDK looks up the target at tenant scope
+     *   },
+     * ], { folderKey: "<sourceFolderKey>" });
      * ```
      * @internal
      */
@@ -2172,15 +2421,19 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * Deletes a Data Fabric entity and all its records
      *
      * @param id - UUID of the entity to delete
+     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the entity is deleted
      *
      * @example
      * ```typescript
      * await entities.deleteById("<entityId>");
+     *
+     * // Folder-scoped: pass the entity's folder key
+     * await entities.deleteById("<entityId>", { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(id: string): Promise<void>;
+    deleteById(id: string, options?: EntityDeleteByIdOptions): Promise<void>;
     /**
      * Updates an existing Data Fabric entity — schema and/or metadata.
      *
@@ -2193,7 +2446,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * overwrite each other's changes.
      *
      * @param id - UUID of the entity to update
-     * @param options - Changes to apply ({@link EntityUpdateByIdOptions})
+     * @param options - Changes to apply ({@link EntityUpdateByIdOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -2226,6 +2479,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *     { id: "<fieldId>", lengthLimit: 1000 },
      *   ],
      * });
+     *
+     * // Folder-scoped entity: add a field to an entity that lives in a non-tenant folder
+     * await entities.updateById("<entityId>", {
+     *   folderKey: "<folderKey>",
+     *   addFields: [{ fieldName: "notes", type: EntityFieldDataType.MULTILINE_TEXT }],
+     * });
      * ```
      * @internal
      */
@@ -2270,6 +2529,8 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @private
      */
     private mapExternalFields;
+    private buildFieldsWithReferenceMeta;
+    private buildReferenceMeta;
     /** Converts a user-facing EntityCreateFieldOptions to the raw API field payload */
     private buildSchemaFieldPayload;
     /**
@@ -2343,40 +2604,54 @@ interface ChoiceSetGetResponse {
     /** User ID of the record owner */
     recordOwner?: string;
 }
+interface ChoiceSetGetAllOptions extends EntityFolderScopedOptions {
+    /**
+     * When `true`, also returns folder-level choice sets alongside tenant ones.
+     * Omit (or `false`, the default) to return only tenant-level choice sets.
+     * Ignored when `folderKey` is provided — `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    includeFolderChoiceSets?: boolean;
+}
 /**
  * Options for getting choice set values by choice set ID
  */
-type ChoiceSetGetByIdOptions = PaginationOptions;
+type ChoiceSetGetByIdOptions = PaginationOptions & EntityFolderScopedOptions;
 /**
  * Options for creating a new choice set
  */
-interface ChoiceSetCreateOptions {
+interface ChoiceSetCreateOptions extends EntityFolderScopedOptions {
     /** Human-readable display name */
     displayName?: string;
     /** Optional choice set description */
     description?: string;
-    /** UUID of the folder to place the choice set in (defaults to the tenant-level folder) */
-    folderKey?: string;
 }
 /**
  * Options for updating an existing choice set's metadata
  */
-interface ChoiceSetUpdateOptions {
+interface ChoiceSetUpdateOptions extends EntityFolderScopedOptions {
     /** New display name for the choice set */
     displayName?: string;
     /** New description for the choice set */
     description?: string;
 }
+interface ChoiceSetDeleteByIdOptions extends EntityFolderScopedOptions {
+}
 /**
  * Optional fields when inserting a single value into a choice set.
  *
  * The required `name` identifier is passed as a positional argument to
  * `insertValueById`.
  */
-interface ChoiceSetValueInsertOptions {
+interface ChoiceSetValueInsertOptions extends EntityFolderScopedOptions {
     /** Human-readable display name */
     displayName?: string;
 }
+interface ChoiceSetValueUpdateOptions extends EntityFolderScopedOptions {
+}
+interface ChoiceSetValueDeleteOptions extends EntityFolderScopedOptions {
+}
 /**
  * Response returned after inserting a choice-set value — the full value object.
  */
@@ -2406,33 +2681,32 @@ interface ChoiceSetValueUpdateResponse extends ChoiceSetGetResponse {
  */
 interface ChoiceSetServiceModel {
     /**
-     * Gets all choice sets in the org
+     * Gets choice sets in the tenant.
+     *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level choice sets.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only choice sets in that folder.
+     * - `getAll({ includeFolderChoiceSets: true })` — returns tenant-level **and** folder-level choice sets together. `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
      *
+     * @param options - Optional {@link ChoiceSetGetAllOptions} (`folderKey` to list a single folder's choice sets — preferred when scoping to a folder; `includeFolderChoiceSets: true` to list tenant + folder choice sets together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of choice set metadata
      * {@link ChoiceSetGetAllResponse}
      * @example
      * ```typescript
-     * // Get all choice sets
-     * const allChoiceSets = await choicesets.getAll();
+     * // Tenant-only (default)
+     * const tenantChoiceSets = await choicesets.getAll();
      *
-     * // Iterate through choice sets
-     * allChoiceSets.forEach(choiceSet => {
-     *   console.log(`ChoiceSet: ${choiceSet.displayName} (${choiceSet.name})`);
-     *   console.log(`Description: ${choiceSet.description}`);
-     *   console.log(`Created by: ${choiceSet.createdBy}`);
-     * });
+     * // A single folder's choice sets (preferred when targeting a specific folder)
+     * const folderChoiceSets = await choicesets.getAll({ folderKey: "<folderKey>" });
      *
-     * // Find a specific choice set by name
-     * const expenseTypes = allChoiceSets.find(cs => cs.name === 'ExpenseTypes');
+     * // Tenant + folder choice sets together
+     * const allChoiceSets = await choicesets.getAll({ includeFolderChoiceSets: true });
      *
-     * // Check choice set details
-     * if (expenseTypes) {
-     *   console.log(`Last updated: ${expenseTypes.updatedTime}`);
-     *   console.log(`Updated by: ${expenseTypes.updatedBy}`);
-     * }
+     * // Find a specific choice set by name
+     * const expenseTypes = tenantChoiceSets.find(cs => cs.name === 'ExpenseTypes');
      * ```
      */
-    getAll(): Promise<ChoiceSetGetAllResponse[]>;
+    getAll(options?: ChoiceSetGetAllOptions): Promise<ChoiceSetGetAllResponse[]>;
     /**
      * Gets choice set values by choice set ID with optional pagination
      *
@@ -2441,7 +2715,7 @@ interface ChoiceSetServiceModel {
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param choiceSetId - UUID of the choice set
-     * @param options - Pagination options
+     * @param options - Pagination options and optional `folderKey` (omit for tenant-level choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving to choice set values or paginated result
      * {@link ChoiceSetGetResponse}
      * @example
@@ -2466,6 +2740,9 @@ interface ChoiceSetServiceModel {
      * if (page1.hasNextPage) {
      *   const page2 = await choicesets.getById(choiceSetId, { cursor: page1.nextCursor });
      * }
+     *
+     * // Folder-scoped choice set
+     * const folderValues = await choicesets.getById(choiceSetId, { folderKey: "<folderKey>" });
      * ```
      */
     getById<T extends ChoiceSetGetByIdOptions = ChoiceSetGetByIdOptions>(choiceSetId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ChoiceSetGetResponse> : NonPaginatedResponse<ChoiceSetGetResponse>>;
@@ -2475,7 +2752,7 @@ interface ChoiceSetServiceModel {
      * @param name - Choice set name. Must start with a
      *   letter, may contain only letters, numbers, and underscores, length
      *   3–100 characters (e.g., `"expenseTypes"`).
-     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions})
+     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the UUID of the created choice set
      *
      * @example
@@ -2499,7 +2776,7 @@ interface ChoiceSetServiceModel {
      * the call throws `ValidationError` if both are omitted.
      *
      * @param choiceSetId - UUID of the choice set to update
-     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions})
+     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -2520,6 +2797,7 @@ interface ChoiceSetServiceModel {
      * Deletes a Data Fabric choice set and all its values.
      *
      * @param choiceSetId - UUID of the choice set to delete
+     * @param options - Optional {@link ChoiceSetDeleteByIdOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level The `folderKey` property is **experimental**.
      * @returns Promise resolving when the choice set is deleted
      *
      * @example
@@ -2529,16 +2807,19 @@ interface ChoiceSetServiceModel {
      * const expenseTypes = allChoiceSets.find(cs => cs.name === 'expense_types');
      *
      * await choicesets.deleteById(expenseTypes.id);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteById(expenseTypes.id, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(choiceSetId: string): Promise<void>;
+    deleteById(choiceSetId: string, options?: ChoiceSetDeleteByIdOptions): Promise<void>;
     /**
      * Inserts a single value into a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param name - Identifier name of the new value (e.g., `"TRAVEL"`)
-     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions})
+     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted value ({@link ChoiceSetValueInsertResponse})
      *
      * @example
@@ -2551,6 +2832,12 @@ interface ChoiceSetServiceModel {
      *   displayName: 'Travel',
      * });
      * console.log(inserted.id);
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.insertValueById(expenseTypes.id, 'TRAVEL', {
+     *   displayName: 'Travel',
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
@@ -2564,6 +2851,7 @@ interface ChoiceSetServiceModel {
      * @param choiceSetId - UUID of the parent choice set
      * @param valueId - UUID of the value to update
      * @param displayName - New human-readable display name for the value
+     * @param options - Optional {@link ChoiceSetValueUpdateOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level. The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated value ({@link ChoiceSetValueUpdateResponse})
      *
      * @example
@@ -2575,15 +2863,21 @@ interface ChoiceSetServiceModel {
      * const travel = values.items.find(v => v.name === 'TRAVEL');
      *
      * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel');
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel', {
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
-    updateValueById(choiceSetId: string, valueId: string, displayName: string): Promise<ChoiceSetValueUpdateResponse>;
+    updateValueById(choiceSetId: string, valueId: string, displayName: string, options?: ChoiceSetValueUpdateOptions): Promise<ChoiceSetValueUpdateResponse>;
     /**
      * Deletes one or more values from a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param valueIds - Array of value UUIDs to delete
+     * @param options - Optional {@link ChoiceSetValueDeleteOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level The `folderKey` property is **experimental**.
      * @returns Promise resolving when the values are deleted
      *
      * @example
@@ -2593,16 +2887,25 @@ interface ChoiceSetServiceModel {
      * const idsToDelete = values.items.slice(0, 2).map(v => v.id);
      *
      * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteValuesById(choiceSetId: string, valueIds: string[]): Promise<void>;
+    deleteValuesById(choiceSetId: string, valueIds: string[], options?: ChoiceSetValueDeleteOptions): Promise<void>;
 }
 
 declare class ChoiceSetService extends BaseService implements ChoiceSetServiceModel {
     /**
-     * Gets all choice sets in the system
+     * Gets choice sets in the tenant.
      *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level choice sets.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only choice sets in that folder.
+     * - `getAll({ includeFolderChoiceSets: true })` — returns tenant-level **and** folder-level choice sets together. `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
+     *
+     * @param options - Optional {@link ChoiceSetGetAllOptions} (`folderKey` to list a single folder's choice sets — preferred when scoping to a folder; `includeFolderChoiceSets: true` to list tenant + folder choice sets together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of choice set metadata
      *
      * @example
@@ -2611,17 +2914,23 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      *
      * const choiceSets = new ChoiceSets(sdk);
      *
-     * // Get all choice sets
-     * const allChoiceSets = await choiceSets.getAll();
+     * // Tenant-only (default)
+     * const tenantChoiceSets = await choiceSets.getAll();
      *
-     * // Iterate through choice sets
-     * allChoiceSets.forEach(choiceSet => {
-     *   console.log(`ChoiceSet: ${choiceSet.displayName} (${choiceSet.name})`);
-     *   console.log(`Description: ${choiceSet.description}`);
-     * });
+     * // A single folder's choice sets (preferred when targeting a specific folder)
+     * const folderChoiceSets = await choiceSets.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder choice sets together
+     * const allChoiceSets = await choiceSets.getAll({ includeFolderChoiceSets: true });
      * ```
      */
-    getAll(): Promise<ChoiceSetGetAllResponse[]>;
+    getAll(options?: ChoiceSetGetAllOptions): Promise<ChoiceSetGetAllResponse[]>;
+    /**
+     * Internal helper that performs the choice-set fetch. Kept separate from the
+     * public `getAll()` so that internal callers (e.g. `resolveChoiceSetName`)
+     * can reuse it without triggering double `@track` telemetry.
+     */
+    private fetchAllChoiceSets;
     /**
      * Gets choice set values by choice set ID with optional pagination
      *
@@ -2630,7 +2939,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param choiceSetId - UUID of the choice set
-     * @param options - Pagination options
+     * @param options - Pagination options and optional `folderKey` for folder-scoped choice sets The `folderKey` property is **experimental**.
      * @returns Promise resolving to choice set values or paginated result
      *
      * @example
@@ -2659,6 +2968,9 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * if (page1.hasNextPage) {
      *   const page2 = await choiceSets.getById(choiceSetId, { cursor: page1.nextCursor });
      * }
+     *
+     * // Folder-scoped choice set
+     * const folderValues = await choiceSets.getById(choiceSetId, { folderKey: "<folderKey>" });
      * ```
      */
     getById<T extends ChoiceSetGetByIdOptions = ChoiceSetGetByIdOptions>(choiceSetId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ChoiceSetGetResponse> : NonPaginatedResponse<ChoiceSetGetResponse>>;
@@ -2668,7 +2980,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * @param name - Choice set name. Must start with a
      *   letter, may contain only letters, numbers, and underscores, length
      *   3–100 characters (e.g., `"expenseTypes"`).
-     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions})
+     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the UUID of the created choice set
      *
      * @example
@@ -2696,7 +3008,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * the call throws `ValidationError` if both are omitted.
      *
      * @param choiceSetId - UUID of the choice set to update
-     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions})
+     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -2717,6 +3029,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * Deletes a Data Fabric choice set and all its values.
      *
      * @param choiceSetId - UUID of the choice set to delete
+     * @param options - Optional {@link ChoiceSetDeleteByIdOptions} (e.g. `folderKey` for folder-scoped choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the choice set is deleted
      *
      * @example
@@ -2726,16 +3039,19 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const expenseTypes = allChoiceSets.find(cs => cs.name === 'expense_types');
      *
      * await choicesets.deleteById(expenseTypes.id);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteById(expenseTypes.id, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(choiceSetId: string): Promise<void>;
+    deleteById(choiceSetId: string, options?: ChoiceSetDeleteByIdOptions): Promise<void>;
     /**
      * Inserts a single value into a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param name - Identifier name of the new value (e.g., `"TRAVEL"`)
-     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions})
+     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted value ({@link ChoiceSetValueInsertResponse})
      *
      * @example
@@ -2748,6 +3064,12 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      *   displayName: 'Travel',
      * });
      * console.log(inserted.id);
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.insertValueById(expenseTypes.id, 'TRAVEL', {
+     *   displayName: 'Travel',
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
@@ -2761,6 +3083,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * @param choiceSetId - UUID of the parent choice set
      * @param valueId - UUID of the value to update
      * @param displayName - New human-readable display name for the value
+     * @param options - Optional {@link ChoiceSetValueUpdateOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level. The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated value ({@link ChoiceSetValueUpdateResponse})
      *
      * @example
@@ -2772,15 +3095,21 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const travel = values.items.find(v => v.name === 'TRAVEL');
      *
      * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel');
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel', {
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
-    updateValueById(choiceSetId: string, valueId: string, displayName: string): Promise<ChoiceSetValueUpdateResponse>;
+    updateValueById(choiceSetId: string, valueId: string, displayName: string, options?: ChoiceSetValueUpdateOptions): Promise<ChoiceSetValueUpdateResponse>;
     /**
      * Deletes one or more values from a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param valueIds - Array of value UUIDs to delete
+     * @param options - Optional {@link ChoiceSetValueDeleteOptions} (e.g. `folderKey` for folder-scoped choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the values are deleted
      *
      * @example
@@ -2790,12 +3119,15 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const idsToDelete = values.items.slice(0, 2).map(v => v.id);
      *
      * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteValuesById(choiceSetId: string, valueIds: string[]): Promise<void>;
+    deleteValuesById(choiceSetId: string, valueIds: string[], options?: ChoiceSetValueDeleteOptions): Promise<void>;
     private resolveChoiceSetName;
 }
 
 export { ChoiceSetService, ChoiceSetService as ChoiceSets, DataDirectionType, EntityService as Entities, EntityAggregateFunction, EntityFieldDataType, EntityService, EntityType, FieldDisplayType, JoinType, LogicalOperator, QueryFilterOperator, ReferenceType, createEntityWithMethods };
-export type { ChoiceSetCreateOptions, ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, ChoiceSetUpdateOptions, ChoiceSetValueInsertOptions, ChoiceSetValueInsertResponse, ChoiceSetValueUpdateResponse, EntityAggregate, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentResponse, EntityDeleteOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityGetAllRecordsOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria, SqlType };
+export type { ChoiceSetCreateOptions, ChoiceSetDeleteByIdOptions, ChoiceSetGetAllOptions, ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, ChoiceSetUpdateOptions, ChoiceSetValueDeleteOptions, ChoiceSetValueInsertOptions, ChoiceSetValueInsertResponse, ChoiceSetValueUpdateOptions, ChoiceSetValueUpdateResponse, EntityAggregate, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentOptions, EntityDeleteAttachmentResponse, EntityDeleteByIdOptions, EntityDeleteOptions, EntityDeleteRecordByIdOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityDownloadAttachmentOptions, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityFolderScopedOptions, EntityGetAllOptions, EntityGetAllRecordsOptions, EntityGetByIdOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsByIdOptions, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, FailureRecord, Field, FieldDataType, FieldMetaData, RawEntityGetResponse, SourceJoinCriteria, SqlType };