Activate a Service
The BIM 360 API exposes an endpoint to add a Project Admin to a specific project. You need to specify the service type (glue, field, plan, docs) to which you are adding this Project Admin. This step will activate that specific service for a specific project. This tutorial explains how to assign a Project Admin and activate a service for a BIM 360 project.
Before You Begin
Make sure that you have registered an app. and successfully acquired an OAuth token with the account:write
scope.
Make sure that you have access to the BIM 360 account that you want to create the company in and have acquired the account_id
. In order to access a specific BIM 360 account, you need to have completed the steps detailed in the Get Access to an Account tutorial.
Step 1: Assign a Project Admin and Activate a Service
The BIM 360 API exposes a POST projects/:project_id/users endpoint that allows assigning a Project Admin to a specific project and a service type.
Note that account_id
, project_id
, and company_id
are required in this API call. Service type (service_type
) has to be specified to indicate the BIM 360 service. Please refer to service type list in the Parameters guide for valid values. You can activate only one service at a time and add one Project Admin at a time.
Example Request
curl -H "Content-Type: application/json" -H "Authorization: Bearer hW0DvSvGgszPis1Yhot4c8kWW3NG" -X POST
https://developer.api.autodesk.com/hq/v1/accounts/9dbb160e-b904-458b-bc5c-ed184687592d/projects/1e4bdc48-1bd7-4a4f-a91f-bd238cce5830/users
-d '
{
"service_type": "field",
"company_id":"14e95a5e-02eb-49aa-a39a-447d90544873",
"email":"john.smith@mail.com",
"nickname":"Johnny",
"first_name":"John",
"last_name":"Smith",
"role": "project_admin",
"image_url": "http://static-dc.autodesk.net/etc/designs/v201412151200/autodesk/adsk-design/images/autodesk_header_logo_140x23.png",
"address_line_1": "The Fifth Avenue",
"address_line_2": "#301",
"city": "New York",
"postal_code": "10011",
"state_or_province": "New York",
"country": "United States",
"phone": "(634)329-2353",
"company": "Autodesk",
"job_title": "Software Developer",
"industry": "IT",
"about_me": "Nothing here"
}'
On success, this will add the Project Admin to a specific project and service and activate the service.
Step 2: Project Admin Login to BIM 360
The Project Admin has now been assigned to the project for a specific service. An invitation email will be sent to the email address of the Project Admin, who can click the link in the email to log into the corresponding BIM 360 product.