Queries
folderByHubId
Retrieve folder specified by the provided Id.
Template for Query:
query GetFolderByHubId($hubId: ID!, $folderId: ID!) {
folderByHubId(hubId: $hubId, folderId: $folderId) {
# Folder Fields
}
}
Arguments
| hubId* ID! non-null | The ID of the Hub that contains the item. |
| folderId* ID! non-null | The ID of the item to retrieve. |
* Required
Possible Returns
| Value Type | Description |
|---|---|
| Folder | Represents a folder. A folder is a location for storing files, data, and other folders (sub-folders). |
Examples
Example 1
Retrieves details of the folder by id along with the hub and project details.
Query:
query GetFolder($hubId: ID!, $folderId: ID!) {
folderByHubId(hubId: $hubId, folderId: $folderId) {
id
name
objectCount
createdOn
parentFolder {
name
}
hub {
id
name
}
project {
id
name
alternativeIdentifiers{
dataManagementAPIProjectId
}
}
}
}
Show More
Query Variables:
{
"hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
"folderId": "urn:adsk.wipstg:fs.folder:co.e1RDpnm3TjaqIr_ZOy9RFA"
}
Response:
{
"data": {
"folderByHubId": {
"id": "urn:adsk.wipstg:fs.folder:co.e1RDpnm3TjaqIr_ZOy9RFA",
"name": "Folder 01",
"objectCount": 1,
"createdOn": "2026-01-16T11:29:39.000Z",
"parentFolder": {
"name": "Connectors"
},
"hub": {
"id": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
"name": "Manufacturing Data Model API Version 3"
},
"project": {
"id": "urn:adsk.workspace:beta.project:99497e80-4c1f-4ca7-8132-4bf1735e4d68",
"name": "Espresso Machine",
"alternativeIdentifiers": {
"dataManagementAPIProjectId": "a.YnVzaW5lc3M6eW9wbWFpbDkxNjMjMjAyNjAxMTYxMzMwOTc1MDE"
}
}
}
}
}
Show More