ACC Admin API: new API to list all projects for a specified user

We’re excited to announce a new API enhancement that allows you to retrieve all projects associated with a specific user in a more efficient way.

• GET accounts/{accountId}/users/{userId}/projects

What's New?

Previously, there wasn’t a straightforward method to get all the projects a particular user was involved in. Developers had to:

1. List all projects within the account
2. Iterate through each project to check if the user was a member

This approach was tedious and inefficient. With this new API, you can now fetch all the projects a user participates in with a single request — and even apply filters to narrow down the results.

Key Highlights

• Supports both ACC and BIM 360 projects
• Efficient: No need to loop through all projects manually
• Flexible filtering options to fine-tune your queries

Important Notes

This API involves two types of user IDs:

• User-Id (Header parameter): This represents the user on whose behalf the request is being made.

  • Must be an Account Admin
  • Not needed for 3-legged OAuth
  • For 2-legged OAuth, it's optional, required if you want to specify an admin user, but you can also ignore this if don't want to specify an admin user.

• userId (URI parameter): This is the ID of the user whose projects you want to retrieve.

Supports Secure Service Accounts

If you are using SSA (Secure Service Accounts), make sure you do the following:

• Using SSA token as 3LO, the SSA user must have Account Admin permission.
• The SSA token must have account:read scope.
• You can check the projects that the SSA user is involved in.  Use the `serviceAccountId` as in the URI parameter of userId.