LibraryManager::FindLibraries recommended instead of ACAPI_LibraryManagement_GetLibraries

Tamas Polyak — Tue, 28 Jul 2026 22:09:48 GMT

Dear Developers,

Recently we got feedback about a substantial slowdown in case of having multiple addons that use the deprecated ACAPI_LibraryManagement_GetLibraries in BIM Cloud projects using many libraries, like in case of the Global library.

It fills an array of API_LibraryInfo structures, and fills the bool readOnly member for each. At this point it's costly because it builds a connection to the appropriate BIM Cloud server, asks for permissions. In case of many addons doing this in succession it can take a lot of time.

If you only want to enumerate the loaded libraries and treat them as read only, we recommend instead the ACAPI::Library::LibraryManager::FindLibraries function that returns an array of ACAPI::Library::Library objects. It contains all the relevant information, except for the readOnly flag.

If you need to modify the contents of a BIM Cloud library from within a joined project via an addon, unfortunately there's no workaround yet.

Best regards,

Tamás

topic LibraryManager::FindLibraries recommended instead of ACAPI_LibraryManagement_GetLibraries in Archicad C++ API

LibraryManager::FindLibraries recommended instead of ACAPI_LibraryManagement_GetLibraries