Request

Response

    Queries

    folderByHubId

    query

    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 TypeDescription
    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