Clarity began supporting BIM 360 in 2015, when only the US region was available. As Autodesk expanded its cloud offerings to include additional regions, customers now have the option to host hubs in multiple locales, such as EMEA and Canada.

When working with hubs across multiple regions, proper naming conventions are essential for smooth operation. We strongly recommend that customers use unique naming conventions for their hubs that clearly indicate the region where each hub is hosted. For example, you might name your hubs "CompanyName-US", "CompanyName-EMEA", or "CompanyName-Canada".

While Clarity may function with identically named hubs across different regions, this

Bridge models cannot be opened as Live models within Revit, which previously limited your ability to work with these referenced models in Clarity. We've solved this by adding new functionality that allows you to open models as Published directly in Revit.

While this enhancement can be applied to any model in your project, it was specifically designed to address the limitations of bridged models.In the image below, multiple files are selected in the project's Files area to "Open as Published." This ensures Clarity operations run against the latest published versions of these models.

The Clarity App Must Be Active

If you haven't already added the app, here are instructions on how to Add the Clarity App

The very first requirement is that the Clarity App be Active in 360/ACC

360 Project Configuration

The Oauth identity setup in Clarity must be a project member of all projects you want to add to Clarity. That identity must also be a part of the document management team with appropriate permissions to the folders you need to access to be able to perform the tasks you want to run on the project.

You likely have multiple 360

In order to enable Clarity to access ACC projects, the account manager must specifically enable access at the Account level.

To enable access:

1. Sign into the ACC portal as an Account Admin:  https://acc.autodesk.com/
2. Select the Apps icon
3. Select the IMAGINiT Clarity app and Install

   2. We only need access to Document Management
4. The icon will change to look like the image below and will show as Active.
5. The published files should show up in Clarity after about 5 – 10 minutes.

  Note: The Clarity ACC integration relies on the Forge interface for Project/model information; therefore, the models do not exist

If you need to change the path, the version or any other setting specified in the project settings you will need to edit the project.

How to Edit the Project

From the Project Home page, select the pencil and checkbox in the upper right corner, Edit Project.

Select the Project Type tab

To Change the Version of Revit in the Project

If you need to change the version of Revit used for the project select update version. 

This will not upgrade models, it simply sets the version of Revit used to perform tasks.

On the Project Type tab, select Update

Issue

Projects are showing as Stale in Clarity

Cause/Things to Check

• Autodesk Health
  • Were there Autodesk outages that may have affected things?
    • https://health.autodesk.com/

• In Clarity

  • Is the Clarity Monitoring Service still running?
    • Stop/Start the service to rescan everything
      • Server tab, Central Host
  • Is the Oauth for that project still valid?
    • Server tab, Settings, Oauth
      • https://imaginit.helprace.com/i484-clarity-how-to-reset-the-360-oauth-credentials
  • Select Check to see what Hubs/Projects you can see with that Oauth 
    • IF YOU DON'T SEE THE HUB WHEN YOU CHECK, THERE IS SOMETHING WRONG WITH THE APP IN ACC.
      • Try removing the app and reinstalling it and verify it is active. 
    • If you see

Oauth Credentials

THESE ARE REFRESHED BY THE MONITORING SERVICE SO PLEASE MAKE SURE IT IS RUNNING.

360 projects that are in Clarity require that the 360 Oauth identity be Valid so that we can see the Project and files.

This identity must be a member of each project you want to add to Clarity and also be assigned to the document management team.

Symptoms of an invalid Oauth

• Can’t add new 360 projects because they don’t show up on the list of available projects for the hub
• 360 Post actions will not work
• Projects are showing as stale
• Files not

Updated 5/12/26

If you are receiving an email like the one below from a task server, that means we think that the token is invalid somewhere, it could be for a specific version of software.

Why Does this Happen?

Since we don’t see this with all clients, on all versions, we don’t have a definitive answer to that.

A common scenario we see this happen is when varied versions of Revit are launched on the task server, with varied updates, since they register differently in the different versions.

We have a few clients that seem to experience this issue more

Issue

Error when trying to add a 360 project and prerequisites have already been done.

There are no BIM360 - Unified Projects found

Resolution

Check the following files on the host

• C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service\ClarityMonitoringService.exe.config
• C:\inetpub\wwwroot\CentralAdministrator\Web.config

  <system.net>

    <defaultProxy>

      <proxy bypassonlocal="True" usesystemdefault="False"/>

    </defaultProxy>

  </system.net>

Change the highlighted text above to “True”, and then restart the monitoring service.

Log Errors

Monitoring INFO [3] 2021-10-20 16:34:44,513 BIM360CachedProjects - Starting 1/1 token scan. Token Details: (1, OAUTHNAME (Primary)) INFO [3] 2021-10-20 16:34:44,528 BIM360Api - Initialize in-memory access token from database storage. (Token expired.) ERROR [3] 2021-10-20 16:35:05,579 OAuthTokenDataAccess

Most customers using Clarity, also have projects in 360, so your account administrator should have received an email from Autodesk stating that the Issues Version 1.0 will no longer be supported.

The example below is how the email starts.

Subject:  Action Required: BIM 360 Issues v.1.0 API Shutdown – FINAL ALERT

These integrations will not function properly after August 15

Dear BIM 360 Account Administrator,

The deprecation deadline for the BIM 360 Issues version 1.0 API has been extended to August 15, 2023. After August 15, the BIM 360 Issues version 1.0 API will no longer be available.

We noticed

For those who are security-minded, there are some nuances to understand about the BIM360 Security Model, when used with Clarity or with any BIM360-enabled tool.

In the older BIM360 Teams-based approach, Clarity used what is called "Three-legged-Oauth" to connect to A360/BIM360. This meant that we requested access, and you supplied a user whose credentials would be used to access A360/BIM360. The Clarity server at your facility could see ONLY the hubs/projects that the designated user was able to see. 

In the new BIM360, Autodesk created an additional step - an application-based permission for Clarity. BIM360 administrators must enable access to

As you begin to have projects that you want to migrate from older versions of Revit to BIM360, Clarity now (in 2019.1.6) has some updates that can help you with this process.

For example: 

- Need to upgrade from C4R/Revit 2018 to BIM360/Revit 2019? We can help with that!

- Migrate from one BIM360 hub/project to another

Using Clarity for the Migration Process

In most cases, these processes take several steps:

1. Getting the models out - either using the PublishRevitModel, or A360Download to pull files out of where they are currently residing, into a local UNC path on disk.

Since Clarity 2020, it's been possible to specify worksets on a given task. If you've run the RevitDBExport task, then you could see the worksets to choose from on the "Basic" tab.

Starting in Clarity 2021, it is also possible to specify worksets with BIM360 projects (in this case you must have run the RevitDBExport task at least once).

You can use these workset settings to:

• Improve performance by not opening all worksets
• Control visibility

On the "Advanced" tab, it's also possible to specify wildcards - as well as negative wildcards (such as "don't show anything that includes the word