Creating a new project with the ACC API

[JvBMov]

We curently have two environments: a BIM360, US based, and a Autodesk Construction Cloud (ACC), EU based. Automating the creation of a BIM360 project was easy with the BIM360 POST projects API. By changing the hub and url (to accomodate the new environment) for the EMEA based environment (https://developer.api.autodesk.com/hq/v1/regions/eu/accounts/:account_id/projects),  the creation of a project still works. However, the project is of the type BIM360 instead of the new ACC Docs (the one with the arrow, which was created automatically):

The BIM360 documentation states the endpoint is not compatible with ACC projects and to go to the ACC API documentation:

Where there is no documented way to create a new project:

Observing the manual creation of a new project as a ACC admin exposes some new parameters for the "https://developer.api.autodesk.com/bim360/admin/v1/accounts/{accountId}/projects" URL (such as "isAcsUnified": "true"), but this endpoint is not available for client applications and the body parameters are not documented. So the question is, how to automatie the creation of new ACC Docs projects?

[eason.kangEDLV4]

Hi,

I'm Eason from the Forge Help team, and trying to answer your compatibility questions of the Account Admin API respectively:

• You can use POST projects endpoint to create projects for an ACC Hub, but all projects created with this endpoint will be BIM360 projects, not ACC projects, as you found. So, therefore, it's marked as not-forward compatible.
• However, you should be aware of that. Even the POST projects endpoint works for an ACC hub to create the BIM360 projects at this moment, you will use it at your own risk since this endpoint is marked as not-forward compatible. There might be some silent changes without notice.
• Currently, there is no way to create ACC projects by API. The endpoint "https://developer.api.autodesk.com/bim360/admin/v1/accounts/{accountId}/projects" you found is for internal use only. Our engineering team is working hard to bring out new public account admin APIs compatible with ACC for our customers. So, please stay tuned with us. Once it gets released, we will accounce it on our official blog: https://forge.autodesk.com/blog

Hope it helps.

Cheers,

[JvBMov]

Hi Autodesk team, do you have an update for us? It's 1,5 years later and we'd thought we could automate this process like with B360 again. Thanks!

This also applies to retrieving project users: the older b360 endpoints stopped or are not working (per documentation and in practice), so how to achieve the same as the GUI call

https://developer.api.autodesk.com/construction/admin/v1/projects/{projectId}/users?limit=50&offset=0&orFilters=name,email&filter[products]=projectAdministration&sort=name asc

[JLGBIM-Support]

Has there been any more development on this? Any roadmap or plan?

[bthompson]

Any updates?

[eason.kangEDLV4]

Now, ACC Admin API is under private beta. Could you send me your APS Client ID and ACC Account ID via the forum's private message? I can help ask our engineering team if the private beta is still applicable.

Update to those who are interested in the ACC Admin API

The ACC Admin API is under private beta.  But unfortunately, the private beta slot is full now. The private beta program is directly supported by our engineering team, so we only have limited seats.

However, I can help add you to the waitlist. Once the private beta seats are available, we can quickly add you to the participants' list. So, if you're interested, please share the below info via private message:

• Your full name
• Your company name
• APS (formerly Forge) Client ID
• ACC Account ID

Cheers,

[ltucker22VY7]

Hello, I was curious if there was an update on projected time the ACC Admin Project Create API would be available for public use and out of the private beta?

[willjbird]

Any update on this?

[floretti]

I'm also very interested as we are looking to move all our projects (approx 1000 at the moment) to ACC and doing this manually is just not an option. Thank you.

[JLGBIM-Support]

We want to also show interest in the development of said API. I've seen somewhere on stack overflow there was a private beta for the project creation API. Do you have any response at this time? 

[andybrack]

I am also interested in this topic. We currently set up the projects manually in ACC. Our Autodesk Customer Success team has been pushing hard to get us to use ACC and the automation capability would help significantly.

[floretti]

Not exactly a solution but if you need to create lots of projects in ACC (like I will in a few months) it might be worth looking into web automation tools such as Microsoft Power Automate (tutorial here) or just make your own in C# (tutorial here).

It's a workaround that involves a lot of effort as opposed to simply using some POST projects but depending on how many/often projects need to be created it may be a good option.

[JvBMov · Accepted solution]

@Anonymous, the beta has now moved to production:

https://aps.autodesk.com/en/docs/acc/v1/change_history/admin_v1_changelog/

[eason.kangEDLV4]

Hi all,

Please accept our sincere apologies for the delay!

@JvBMov is correct. Our product team released ACC Admin API at AU Les Vegas just now. We will also have a webinar for ACC Admin API on December 13, 2023.

Please refer to https://aps.autodesk.com/blog/acc-project-admin-api-project-creation-and-user-management for details and notes.

Cheers,