Download API definition:

POST https://sampleHostName/transformations/configurations/combinephysicalmodels

This endpoint is used to create CombinePhysicalModels configuration.

Combine Physical Models transformation combines the source iModel's top level hierarchy physical models to a desired amount of models. More information about internal iModel structure can be found here.

This transformation is usually leveraged to improve performance of iModel viewers. Lack of performance is noticeable when model counts reach ~1000 or even more models. It is recommended to set the numberOfModels property to ~ 5-20 and test the performance of the iModel.

Configuration specific properties explained:

numberOfModels - specify amount of models to transform the source iModel into.
simplifyGeometry - optional parameter indicating if geometry simplification should be used (transforming parasolids to meshes). Default if not specified - false.

Creating a configuration does not actually run the transformation. To run the transformation check out POST /transformations reference.


Requires Authorization header with valid Bearer token for scope transformations:modify.

For more documentation on authorization and how to get access token visit OAUTH2 Authorization page.


User must have imodels_write permission assigned at the iModel level and at least imodels_webview permission assigned at the Project level. If permissions at the iModel level are not configured, then user must have imodels_write permission assigned at the Project level.

Alternatively the user should be an Organization Administrator for the Organization that owns a given Project the iModel belongs to.

An Organization Administrator must have at least one of the following roles assigned in User Management: Account Administrator, Co-Administrator, or CONNECT Services Administrator. For more information about User Management please visit our Bentley Communities Licensing, Cloud, and Web Services wiki page.