Enterprise Scale #1

BIM 360 to ACC: The Migration Nobody Planned For

Autodesk forced the BIM 360 to ACC migration with no bulk tooling. Thousands of teams were left to figure it out alone.

#acc #bim360 #migration #autodesk #enterprise #aec
Dmytro Yemelianov - Author
Dmytro Yemelianov
Autodesk Expert Elite โ€ข APS Developer

In 2023, Autodesk announced the mandatory migration from BIM 360 to Autodesk Construction Cloud. No bulk migration tooling. No permission transfer utility. No project-level export. Thousands of companies โ€” some with hundreds of active projects โ€” were told to migrate. Manually.

This is the story of what that actually means for the people on the ground.


The Scale of the Problem

BIM 360 was the construction industryโ€™s default cloud platform for years. Document management, issue tracking, RFIs, submittals, model coordination โ€” it all lived in BIM 360. Entire enterprises built their workflows around it.

Then Autodesk replaced it with ACC: a different architecture, different APIs, a different permission model. And they made migration mandatory. BIM 360 features were deprecated on a rolling basis. There was no โ€œstay where you areโ€ option.

For a small firm with five projects, this was an inconvenience. For an enterprise customer with hundreds or thousands of projects, each containing users, permissions, folder structures, documents, issues, and RFIs โ€” this was a crisis.

1000+
Projects (large enterprises)
200+
Users per project
100+
Folder structures each

No official bulk migration path was provided.


What Autodesk Provided

Autodesk shipped a web UI that migrates one project at a time. Their documentation recommended contacting support for large migrations. That was it.

Under the hood, the Admin API technically supports both platforms โ€” but with different endpoints, different authentication flows, and different data models. The HQ v1 API (BIM 360) and the Construction Admin v1 API (ACC) use different field names for the same concepts. Even the account ID format changed: BIM 360 used a plain UUID, ACC wraps it in a b. prefix with base64 encoding.

Two Platforms, Two APIs, Same Data

BIM 360 HQ v1
GET /hq/v1/accounts/{account_id}/projectsPOST /hq/v1/accounts/{account_id}/projects/{id}/users
Field: โ€œaccess_levelโ€
ACC Construction Admin v1
GET /construction/admin/v1/projectsPOST /construction/admin/v1/projects/{id}/users
Field: โ€œroleโ€ (different values)

For any team that had built internal tooling, scripts, or integrations against BIM 360 โ€” every single one broke on migration day.


What Actually Breaks in Migration

This is where the reality sets in. Migration is not just โ€œmove files from A to B.โ€ It is a cascade of incompatibilities across every layer of the platform.

User Roles

BIM 360 roles do not map 1:1 to ACC roles. โ€œProject Adminโ€ in BIM 360 becomes a different set of capabilities in ACC. Custom roles are lost entirely. Teams discover permission gaps weeks after migration when someone can no longer access a folder they need.

Folder Permissions

The permission inheritance model changed. In BIM 360, folder permissions cascaded in one way. In ACC, they work differently. Migrated folders often end up with either too much access or too little โ€” both dangerous on a construction project with sensitive bid documents.

Custom Attributes

Custom metadata attached to documents, issues, and submittals in BIM 360 does not transfer cleanly. Some is lost. Some arrives in the wrong format. Audit trails break.

Integration Webhooks

Every webhook registered against BIM 360 endpoints needs to be re-created on ACC endpoints. Different event types, different payload structures. Automation pipelines go silent on migration day.

API Endpoints

Every integration pointing to BIM 360 URLs stops working. There is no redirect, no compatibility layer. If your Revit plugin, your Power BI dashboard, or your scheduling tool talked to BIM 360 โ€” it is broken until someone rewrites the connection.

Active Projects

You cannot pause construction to migrate. Buildings are being built. Concrete is being poured. Teams need access to their documents today, not after a migration window. The migration has to happen live, with active users depending on the data.


The RCW Problem

Revit Cloud Worksharing is the hardest piece of the migration puzzle. Revit models hosted in BIM 360 use cloud worksharing โ€” live, multi-user collaboration on a single model file. These are not static documents. They are active working files with multiple architects and engineers editing simultaneously.

Migrating an RCW model means:

  • All active users must stop working
  • The model must be fully synchronized
  • Cloud worksharing must be re-established on the ACC side
  • All user permissions must be re-mapped
  • Worksharing bookmarks and links must be updated

An Autodesk engineer identified up to 5 enterprise clients who needed bulk RCW migration. No tooling exists for it. Each client had to work with Autodesk support on a case-by-case basis.

For everyone else, it was manual. Model by model. Project by project.


How RAPS Handles Both Platforms

RAPS was built for exactly this kind of problem. The raps-acc crate contains both the BIM 360 HQ v1 and ACC Construction Admin v1 endpoint implementations. The CLI auto-detects which platform a project lives on and uses the correct API.

# RAPS auto-detects BIM 360 vs ACC and uses the right API
raps project list --hub-id "b.account-id"

# Works for both BIM 360 HQ v1 and ACC Construction Admin v1
raps project create --name "New Project" --hub-id "b.account-id"

# Bulk user operations across mixed BIM 360 + ACC projects
raps admin user add "$ACCOUNT" "user@company.com" --role project_admin

# Export permissions from BIM 360, import to ACC
raps admin folder set-permissions "$ACCOUNT" --project "$OLD" --export perms.csv
raps admin folder set-permissions "$ACCOUNT" --project "$NEW" --import perms.csv

The key design decision: same command interface regardless of platform version. A script that works against BIM 360 today works against ACC tomorrow without modification.


Backward Compatibility Architecture

Under the hood, this is how RAPS handles the platform split:

RAPS Platform Detection Flow

1
Command issued against a hub or account ID
2
RAPS checks hub type: a. prefix = ACC, b. prefix = BIM 360 or ACC
3
Tries ACC Construction Admin v1 endpoint first
4
On failure, falls back to BIM 360 HQ v1 endpoint
5
Normalizes response into a unified data model

This means existing automation scripts survive the migration. No rewrites. No branching logic. No โ€œif BIM 360 do X, else do Yโ€ in your CI/CD pipeline.

For teams running mixed environments โ€” some projects already on ACC, some still on BIM 360 โ€” RAPS handles both in the same pipeline run. The permission export/import workflow works across platforms: export from a BIM 360 project, import into an ACC project, and RAPS handles the field mapping.


The Broader Lesson

Forced migrations without tooling are vendor-centric decisions. The vendor saves development cost by not building bulk migration utilities. The customer pays for that savings in manual labor โ€” hundreds of hours of clicking, re-configuring, and re-testing.

This is a pattern that repeats across every major platform transition:

1.
Vendor announces new platform
Marketing materials emphasize new features, not migration cost
2.
Old platform deprecated
Features stop receiving updates, then stop working entirely
3.
Migration tooling is minimal
One-at-a-time UI, basic docs, โ€œcontact supportโ€
4.
Customers absorb the cost
Manual migration, broken integrations, lost metadata, weeks of rework

This is exactly the kind of gap an API User Advocate fills. The vendor will not build the migration path their enterprise customers need โ€” because for the vendor, the migration is a feature they can ship once and move on. For the customer, it is months of operational disruption.

RAPS exists because Autodesk did not build that path.


What Comes Next

The BIM 360 to ACC migration is just the first domino. Once you have migrated your projects, you still need to manage permissions at scale, audit access across hundreds of folders, and keep user roles synchronized as your team changes.

Next in the Enterprise Scale series: Permission Management at Scale โ€” the deep-dive on clone, export, and audit features that make migration manageable.


Related: