Request

Response

    Queries

    item

    query

    Retrieves an object representing an item. An item refers to a file or sub-folder that exists within a folder.

    Template for Query:

    query GetItem($hubId: ID!, $itemId: ID!, $time: DateTime, $composition: ItemCompositionEnum, $resolution: ItemResolutionEnum) {
      item(hubId: $hubId, itemId: $itemId, time: $time, composition: $composition, resolution: $resolution) {
        # Item Fields
      }
    }
    

    Arguments

    hubId*
    ID! non-null
    The ID of the Hub that contains the item.
    itemId*
    ID! non-null
    The ID of the item to retrieve.
    timeThe timestamp to retrieve the item state at a specific point in time.
    compositionThe composition state used to traverse item relations.
    resolutionSnaps the Item at a most recent point in time prior or equal to the time parameter.
    * Required

    Possible Returns

    Value TypeDescription
    Item Represents an Item. An item refers to a file or sub-folder that exists within a folder.


    Examples

    Example 1

    Retrieves an item by ID along with the hub and project it belongs to.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!) {
     item(hubId: $hubId, itemId: $itemId) {
       id
       name
       hub{
           id
           name
       }
       project {
         id
         name
       }
       ... on DesignItem {
         tipRootModel {
           id
           component {
               id
           }
           name {
               value
           }
         }
       }
       ... on DrawingItem {
         id
         name
         tipVersion {
           id
           name
         }
       }
     }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:nP1nOY0WTq2_nnadCvlx9w"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:nP1nOY0WTq2_nnadCvlx9w",
               "name": "Cup",
               "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"
               },
               "tipRootModel": {
                   "id": "bW9kZWx-OWFiTWNGeEtnaFB5Y3d1TW9hR05pa19MMkN-emExWlNFS1BuVEd4NWlvT24wdWdVQV9hZ2E",
                   "component": {
                       "id": "cHJvZHVjdH45YWJNY0Z4S2doUHljd3VNb2FHTmlrX0wyQ35NeWpwUUR6Q3YwdFZQQzBYMVRhUVdPX2FnYQ"
                   },
                   "name": {
                       "value": "Cup"
                   }
               }
           }
       }
    }
    
    Show More

    Example 2

    Returns the paginated list of parent items that directly reference this item — i.e., where this item is used in your design structure.

    Query:

    query GetItemWhereUsed($hubId: ID!, $itemId: ID!) {
       item(hubId: $hubId, itemId: $itemId) {
           ... on DesignItem {
               id
               name
               whereUsed {
                   results {
                       id
                       name
                   }
               }
           }
    
           ... on ConfiguredDesignItem {
               id
               name
               whereUsed {
                   results {
                       id
                       name
                   }
               }
           }
       }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:GE6Q9Ji6TxCsGnlY-NQfIw"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:GE6Q9Ji6TxCsGnlY-NQfIw",
               "name": "L1",
               "whereUsed": {
                   "results": [
                       {
                           "id": "urn:adsk.wipstg:dm.lineage:hOKK77UGSCm5Dt93jSJGKw",
                           "name": "T1"
                       },
                       {
                           "id": "urn:adsk.wipstg:dm.lineage:X5jWAhWsQP6eEiVTzAeA-Q",
                           "name": "T2"
                       }
                   ]
               }
           }
       }
    }
    
    Show More

    Example 3

    Retrieves configured design item details and lists its versions.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!) {
       item(hubId: $hubId, itemId: $itemId) {
           ... on ConfiguredDesignItem {
               id
               name
               extensionType
               versions {
                   results {
                       id
                       name
                       project {
                           id
                           name
                       }
                       hub {
                           id
                           __typename
                       }
                       versionNumber
                       __typename
                       mimeType
                       extensionType
                       configurationTable {
                           id
                           name
                           rows {
                               id
                               name
                           }
                       }
                   }
               }
           }
       }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:y45Qhk2uR-yltJpEpXxTmA"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:y45Qhk2uR-yltJpEpXxTmA",
               "name": "CD_CYL",
               "extensionType": "f3d",
               "versions": {
                   "results": [
                       {
                           "id": "urn:adsk.wipstg:fs.file:vf.y45Qhk2uR-yltJpEpXxTmA?version=2",
                           "name": "CD_CYL",
                           "project": {
                               "id": "urn:adsk.workspace:beta.project:3992ee46-d3ff-47aa-b43e-b0aeabacbf61",
                               "name": "Default Project"
                           },
                           "hub": {
                               "id": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
                               "__typename": "Hub"
                           },
                           "versionNumber": 2,
                           "__typename": "ConfiguredDesignItemVersion",
                           "mimeType": "application/vnd.autodesk.fusion360",
                           "extensionType": "f3d",
                           "configurationTable": {
                               "id": "1",
                               "name": "Configurations",
                               "rows": [
                                   {
                                       "id": "ca0574f2-4465-46bb-b6a4-ad34f8e460e8",
                                       "name": "Configuration_27_20"
                                   },
                                   {
                                       "id": "a353c129-4bb7-4b9f-9dd7-a180754bf82a",
                                       "name": "Configuration_15_15"
                                   },
                                   {
                                       "id": "0b9e2251-6509-46e5-b8ed-71b591d1cdbc",
                                       "name": "Configuration40_80"
                                   },
                                   {
                                       "id": "58c3765c-9b17-4c03-acc8-4873ffca9adb",
                                       "name": "Configuration41_80"
                                   },
                                   {
                                       "id": "0ee8f8c3-5f0b-49a1-992d-6ed01a89c620",
                                       "name": "Configuration_26_20"
                                   },
                                   {
                                       "id": "4325bb58-97af-4948-8992-2c149e89e2bf",
                                       "name": "Configuration42_80"
                                   },
                                   {
                                       "id": "5ae335b8-70d3-4120-96ea-063954508275",
                                       "name": "Configuration_10_10"
                                   },
                                   {
                                       "id": "e03c45ea-027d-4888-8ba1-01064c527f98",
                                       "name": "Configuration_20_20"
                                   },
                                   {
                                       "id": "387c1f32-476b-4975-beb8-2b6ac39017ab",
                                       "name": "Configuration_25_20"
                                   }
                               ]
                           }
                       },
                       {
                           "id": "urn:adsk.wipstg:fs.file:vf.y45Qhk2uR-yltJpEpXxTmA?version=1",
                           "name": "CD_CYL",
                           "project": {
                               "id": "urn:adsk.workspace:beta.project:3992ee46-d3ff-47aa-b43e-b0aeabacbf61",
                               "name": "Default Project"
                           },
                           "hub": {
                               "id": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
                               "__typename": "Hub"
                           },
                           "versionNumber": 1,
                           "__typename": "ConfiguredDesignItemVersion",
                           "mimeType": "application/vnd.autodesk.fusion360",
                           "extensionType": "f3d",
                           "configurationTable": {
                               "id": "1",
                               "name": "Configurations",
                               "rows": [
                                   {
                                       "id": "387c1f32-476b-4975-beb8-2b6ac39017ab",
                                       "name": "Configuration_25_20"
                                   },
                                   {
                                       "id": "4325bb58-97af-4948-8992-2c149e89e2bf",
                                       "name": "Configuration42_80"
                                   },
                                   {
                                       "id": "ca0574f2-4465-46bb-b6a4-ad34f8e460e8",
                                       "name": "Configuration_27_20"
                                   },
                                   {
                                       "id": "58c3765c-9b17-4c03-acc8-4873ffca9adb",
                                       "name": "Configuration41_80"
                                   },
                                   {
                                       "id": "0b9e2251-6509-46e5-b8ed-71b591d1cdbc",
                                       "name": "Configuration40_80"
                                   },
                                   {
                                       "id": "a353c129-4bb7-4b9f-9dd7-a180754bf82a",
                                       "name": "Configuration_15_15"
                                   },
                                   {
                                       "id": "0ee8f8c3-5f0b-49a1-992d-6ed01a89c620",
                                       "name": "Configuration_26_20"
                                   },
                                   {
                                       "id": "5ae335b8-70d3-4120-96ea-063954508275",
                                       "name": "Configuration_10_10"
                                   },
                                   {
                                       "id": "e03c45ea-027d-4888-8ba1-01064c527f98",
                                       "name": "Configuration_20_20"
                                   }
                               ]
                           }
                       }
                   ]
               }
           }
       }
    }
    
    Show More

    Example 4

    Retrieves configured design item details of an item.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!) {
       item(hubId: $hubId, itemId: $itemId) {
           ... on ConfiguredDesignItem {
               id
               name
               tipConfigurationTable {
                   id
                   name
                   rows {
                       id
                       name
                   }
               }
               tipVersion {
                   id
                   name
                   project {
                       id
                       name
                   }
                   versionNumber
                   __typename
                   mimeType
                   extensionType
                   configurationTable {
                       id
                       name
                       rows {
                           id
                           name
                       }
                   }
               }
           }
       }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:y45Qhk2uR-yltJpEpXxTmA"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:y45Qhk2uR-yltJpEpXxTmA",
               "name": "CD_CYL",
               "tipConfigurationTable": {
                   "id": "1",
                   "name": "Configurations",
                   "rows": [
                       {
                           "id": "e03c45ea-027d-4888-8ba1-01064c527f98",
                           "name": "Configuration_20_20"
                       },
                       {
                           "id": "387c1f32-476b-4975-beb8-2b6ac39017ab",
                           "name": "Configuration_25_20"
                       },
                       {
                           "id": "0b9e2251-6509-46e5-b8ed-71b591d1cdbc",
                           "name": "Configuration40_80"
                       },
                       {
                           "id": "4325bb58-97af-4948-8992-2c149e89e2bf",
                           "name": "Configuration42_80"
                       },
                       {
                           "id": "a353c129-4bb7-4b9f-9dd7-a180754bf82a",
                           "name": "Configuration_15_15"
                       },
                       {
                           "id": "ca0574f2-4465-46bb-b6a4-ad34f8e460e8",
                           "name": "Configuration_27_20"
                       },
                       {
                           "id": "0ee8f8c3-5f0b-49a1-992d-6ed01a89c620",
                           "name": "Configuration_26_20"
                       },
                       {
                           "id": "5ae335b8-70d3-4120-96ea-063954508275",
                           "name": "Configuration_10_10"
                       },
                       {
                           "id": "58c3765c-9b17-4c03-acc8-4873ffca9adb",
                           "name": "Configuration41_80"
                       }
                   ]
               },
               "tipVersion": {
                   "id": "urn:adsk.wipstg:fs.file:vf.y45Qhk2uR-yltJpEpXxTmA?version=2",
                   "name": "CD_CYL",
                   "project": {
                       "id": "urn:adsk.workspace:beta.project:3992ee46-d3ff-47aa-b43e-b0aeabacbf61",
                       "name": "Default Project"
                   },
                   "versionNumber": 2,
                   "__typename": "ConfiguredDesignItemVersion",
                   "mimeType": "application/vnd.autodesk.fusion360",
                   "extensionType": "versions:autodesk.fusion360:Design",
                   "configurationTable": {
                       "id": "1",
                       "name": "Configurations",
                       "rows": [
                           {
                               "id": "e03c45ea-027d-4888-8ba1-01064c527f98",
                               "name": "Configuration_20_20"
                           },
                           {
                               "id": "387c1f32-476b-4975-beb8-2b6ac39017ab",
                               "name": "Configuration_25_20"
                           },
                           {
                               "id": "0b9e2251-6509-46e5-b8ed-71b591d1cdbc",
                               "name": "Configuration40_80"
                           },
                           {
                               "id": "4325bb58-97af-4948-8992-2c149e89e2bf",
                               "name": "Configuration42_80"
                           },
                           {
                               "id": "a353c129-4bb7-4b9f-9dd7-a180754bf82a",
                               "name": "Configuration_15_15"
                           },
                           {
                               "id": "ca0574f2-4465-46bb-b6a4-ad34f8e460e8",
                               "name": "Configuration_27_20"
                           },
                           {
                               "id": "0ee8f8c3-5f0b-49a1-992d-6ed01a89c620",
                               "name": "Configuration_26_20"
                           },
                           {
                               "id": "5ae335b8-70d3-4120-96ea-063954508275",
                               "name": "Configuration_10_10"
                           },
                           {
                               "id": "58c3765c-9b17-4c03-acc8-4873ffca9adb",
                               "name": "Configuration41_80"
                           }
                       ]
                   }
               }
           }
       }
    }
    
    Show More

    Example 5

    Retrieves information about the latest version of the design item.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!) {
       item(hubId: $hubId, itemId: $itemId) {
           ... on DesignItem {
               id
               name
               tipVersion{
                   id
                   versionNumber
                   item{
                       tipRootModel{
                           id
                       }
                   }
               }
           }
       }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:nP1nOY0WTq2_nnadCvlx9w"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:nP1nOY0WTq2_nnadCvlx9w",
               "name": "Cup",
               "tipVersion": {
                   "id": "urn:adsk.wipstg:fs.file:vf.nP1nOY0WTq2_nnadCvlx9w?version=3",
                   "versionNumber": 3,
                   "item": {
                       "tipRootModel": {
                           "id": "bW9kZWx-OWFiTWNGeEtnaFB5Y3d1TW9hR05pa19MMkN-emExWlNFS1BuVEd4NWlvT24wdWdVQV9hZ2E"
                       }
                   }
               }
           }
       }
    }
    
    Show More

    Example 6

    Retrieves drawing items linked to a design item at a point in time.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!, $time: DateTime) {
     item(hubId: $hubId, itemId: $itemId, time: $time) {
       ... on DesignItem {
         id
         name
         createdOn
         drawingItems {
           results {
             id
             name
             createdOn
           }
         }
       }
     }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:0ekABZFJSE6xKd40ncQrkA",
     "time": "2026-01-19T14:52:42.982Z"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:0ekABZFJSE6xKd40ncQrkA",
               "name": "Controls",
               "createdOn": "2026-01-16T10:41:11.000Z",
               "drawingItems": {
                   "results": [
                       {
                           "id": "urn:adsk.wipstg:dm.lineage:F47COEIuTxqb8xizLl_qdQ",
                           "name": "Controls Drawing",
                           "createdOn": "2026-01-19T11:34:37.000Z"
                       }
                   ]
               }
           }
       }
    }
    
    Show More

    Example 7

    Retrieves the design item linked to a drawing item at a point in time.

    Query:

    query GetItem($hubId: ID!, $itemId: ID!, $time: DateTime) {
     item(hubId: $hubId, itemId: $itemId, time: $time) {
       ... on DrawingItem {
         id
         name
         createdOn
         designItem {
           id
           name
           createdOn
         }
       }
     }
     }
    
    Show More

    Query Variables:

    {
     "hubId": "urn:adsk.ace:beta.scope:02dd340f-3e84-4db8-b6a1-56a964a202c7",
     "itemId": "urn:adsk.wipstg:dm.lineage:F47COEIuTxqb8xizLl_qdQ",
     "time": "2026-01-19T14:52:42.982Z"
    }
    

    Response:

    {
       "data": {
           "item": {
               "id": "urn:adsk.wipstg:dm.lineage:F47COEIuTxqb8xizLl_qdQ",
               "name": "Controls Drawing",
               "createdOn": "2026-01-19T11:34:37.000Z",
               "designItem": {
                   "id": "urn:adsk.wipstg:dm.lineage:0ekABZFJSE6xKd40ncQrkA",
                   "name": "Controls",
                   "createdOn": "2026-01-16T10:41:11.000Z"
               }
           }
       }
    }
    
    Show More