Retrieve an RFIs Container ID
This tutorial demonstrates how to retrieve a container ID for a BIM 360 project. Each BIM 360 project is assigned an RFIs container (rfisContainerId) that stores all the RFIs data for the project. The RFIs container ID is used to call the BIM 360 RFIs endpoints. To retrieve the ID, you need to call several Data Management endpoints.
Before You Begin
- Register an app
- Acquire a 3-legged OAuth token with the
data:readscope. - Verify that you have access to the relevant BIM 360 account and BIM 360 project. (To create a new BIM 360 project, see POST projects)
Step 1: Find the Hub ID
You first need to call GET hubs to find the hub ID for your BIM 360 account.
Note that the BIM 360 account ID corresponds to a Data Management hub ID. To convert an account ID into a hub ID you need to add a “b." prefix. For example, an account ID of c8b0c73d-3ae9 translates to a hub ID of b.c8b0c73d-3ae9.
Request
curl -X GET -H "Authorization: Bearer nFRJxzCD8OOUr7hzBwbr06D76zAT" "https://developer.api.autodesk.com/project/v1/hubs"
Response
{
"jsonapi": {
"version": "1.0"
},
"links": {
"self": {
"href": "https://developer.api.autodesk.com/project/v1/hubs"
}
},
"data": [
{
"type": "hubs",
"id": "b.cGVyc29uYWw6cGUyOWNjZjMy",
"attributes": {
"name": "My First Account",
"extension": {
"type": "hubs:autodesk.bim360:Account",
"version": "1.0",
"schema": {
"href": "https://developer.api.autodesk.com/schema/v1/versions/hubs:autodesk.bim360:Account-1.0"
},
"data": {}
}
}
}
]
}
In this example, assume that the project you want the container for is in My First Account hub.
Step 2: Find the Container ID for the Project
Use the BIM 360 hub ID that you retrieved in the previous step (b.cGVyc29uYWw6cGUyOWNjZjMy) to call GET hubs/:hub_id/projects, and retrieve a list of all the projects in the hub the user has access to. In this example, we have added a filter to only return details of a specific project (Demo Project).
The response payload includes the RFIs container ID (data.relationships.rfis.data.id).
Request
curl -X GET -H "Authorization: Bearer nFRJxzCD8OOUr7hzBwbr06D76zAT" "https://developer.api.autodesk.com/project/v1/hubs/b.cGVyc29uYWw6cGUyOWNjZjMy/projects?filter%5Battributes.name%5D=Demo%20Project"
Response
{
"jsonapi": {
"version": "1.0"
},
"links": {
"self": {
"href": "https://developer.api.autodesk.com/project/v1/hubs/b.7fcde01c-738a-4f5e-8a1c-7a8da2381693/projects"
}
},
"data": [
{
"type": "projects",
"id": "b.1f50f9e7-df95-43f9-9366-2fd44cafa768",
"attributes": {
"name": "Demo Project",
"extension": {
"type": "projects:autodesk.bim360:Project",
"version": "1.0",
"schema": {
"href": "https://developer.api.autodesk.com/schema/v1/versions/projects:autodesk.bim360:Project-1.0"
},
"data": {}
}
},
"links": {
"self": {
"href": "https://developer.api.autodesk.com/project/v1/hubs/b.7fcde01c-738a-4f5e-8a1c-7a8da2381693/projects/b.1f50f9e7-df95-43f9-9366-2fd44cafa768"
}
},
"relationships": {
"hub": {
"data": {
"type": "hubs",
"id": "b.7fcde01c-738a-4f5e-8a1c-7a8da2381693"
},
"links": {
"related": {
"href": "https://developer.api.autodesk.com/project/v1/hubs/b.7fcde01c-738a-4f5e-8a1c-7a8da2381693"
}
}
},
"rootFolder": {
"data": {
"type": "folders",
"id": "urn:adsk.wipprod:fs.folder:co.xOuT2J3zSdqR4eD_pkd3WQ"
},
"meta": {
"link": {
"href": "https://developer.api.autodesk.com/data/v1/projects/b.1f50f9e7-df95-43f9-9366-2fd44cafa768/folders/urn:adsk.wipprod:fs.folder:co.xOuT2J3zSdqR4eD_pkd3WQ"
}
}
},
"topFolders": {
"links": {
"related": {
"href": "https://developer.api.autodesk.com/project/v1/hubs/b.7fcde01c-738a-4f5e-8a1c-7a8da2381693/projects/b.1f50f9e7-df95-43f9-9366-2fd44cafa768/topFolders"
}
}
},
"rfis": {
"data": {
"type": "rfisContainerId",
"id": "e59adc9d-2677-4afc-a800-4bc42101f7d8"
},
"meta": {
"link": {
"href": "https://developer.api.autodesk.com/bim360/rfis/v1/containers/e59adc9d-2677-4afc-a800-4bc42101f7d8/rfis"
}
}
}
}
}
]
}