Explore the potential of our public beta program for development.
Join nowAbout this Beta
The AEC Data Model API public beta release is an invitation-only testing program which aims to get feedback through hands-on experimentation with an early draft of our APIs. The objective is to validate the current offering, assess the developer experience, and collect valuable feedback so that we can build valuable APIs.
For this beta, participants will be querying design data extracted from the Revit 2024 models uploaded to their sandbox account on ACC Docs.
Using the first preview of the AEC Data Model API, you can build the following capabilities without writing an application-specific plug-in (Revit):
- Identify anomalies within design files for better quality control.
- Generate quantity take-offs, schedules, procurement dashboards, and more.
- Compare differences between various design versions.
We are eager to learn about the different ways you plan to use these APIs.
Guidance
This beta release might have some limitations and known issues. We see the beta program as an opportunity to get valuable feedback and requirements on all aspects of the API and use them to enhance the API.
- Make sure you are working with 2024 version of Revit files.
- Make sure you have an Autodesk Construction Cloud license, and are using the AMER instance of your Autodesk Construction Cloud account.
- Make sure you have access to files in your Autodesk Construction Cloud project.
- Make sure that you provide access to your client ID in your ACC Account by following the steps mentioned here.
Important: At the end of the beta program, we may purge the data that is extracted to AEC Data Model. This will not affect your Revit models on Autodesk Construction Cloud - Autodesk Docs.
AEC Data Model Explorer
To access AEC Data Model Explorer with beta features, use your Autodesk credentials to sign in to aecdatamodel-explorer.autodesk.io. Make sure that you added the “HKVjhUXySDGLGJimolxAgDdpoCuZLlql” client ID to your ACC Hub using the steps mentioned here.
Code samples
The following code sample demonstrates the use of the queries and mutations released in this beta program:
Known limitations
- Linked Revit Models are currently not supported.
- Geometry is currently not supported.
Onboarding Beta Program
This procedure outlines the step-by-step onboarding process for customers who are joining the public beta program. The onboarding process involves creating an account, if you don’t have one already; signing an agreement; accessing program information; submitting necessary details; and providing feedback.
- Joining the Beta Program:
- You can join the beta program portal from the AEC Data Model API documentation landing page or About this Beta page.
- Click the “Join Now” button in the banner, which redirects to the beta site.
- Creating or signing in to an Account:
- If you don’t have an account, you are prompted to create one.
- After signing in, you are taken to the “Autodesk Feedback Community Project Terms” page.
- Signing the agreement and viewing the program information:
- On the “Autodesk Feedback Community Project Terms” page, you must provide the authorized email ID and accept the agreement.
- You will see “What is a beta?” page. Click Continue to go to the “Public Beta Application Form” page.
- Filling in the beta application form:
On the “Public Beta Application Form” page, you will be prompted to indicate whether you are an ACC account administrator.
Note: Please make sure that you are not entering any personal data.
- If you are not an administrator, select No and click Submit.
- If you are an administrator, select Yes, and you will be prompted to indicate whether your ACC account is enabled to extract AEC data model.
- If your account is not enabled, select No. You are asked to provide your ACC account name and ACC account ID so that your account can be provided with the required access.
- If your account is enabled already, select Yes and click Submit.
After submission, you will gain access to the project, its documentation, and user forums.
Providing feedback
On the AEC Data Model API Beta Model welcome page, use the “AEC Data Model Public Beta feedback” section to seek support or report problems faced during the program. Click the “Submit” button to open the form. Alternatively, you can also access the “Problem reports” form from the “Feedback” menu tab.
Click “View Problems Reports” to view the list of feedback.
User forums
Utilize the user forums to participate in discussions, asking questions, and seeking assistance during the beta program. Engage with the user community to discuss issues and receive solutions or troubleshooting advice for any problems encountered.
Requesting new features
For new feature requests, you can submit requests using the “New Feature Requests” form, which is available in the “Feedback” menu tab.
Disclaimer
This API is currently in beta testing. Please note that the API calls are subject to changes based on the feedback received. We recommend not using this API to build production software during this phase. If you have an urgent requirement, we encourage you to contact us before utilizing the API.
