Request

Response

    Retrieve Items by Project or Folder

    This topic provides instructions on how to retrieve the following objects:

    • Items within a project.
    • Items within a folder.
    • A single item by its ID.

    You will use the following operation in this topic:

    TypeOperationDescription
    Query itemsByProject Retrieves Items within a project.
    Query itemsByFolder Retrieves Items within a folder.
    Query item Retrieves a single Item by hub and item ID.

    Step 1 - Retrieve Items within a Project

    The following steps demonstrate how you can run the itemsByProject query to retrieve all the Items within a project.

    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      query GetFolderItemsByProject($projectId: ID!) {
         itemsByProject(projectId: $projectId) {
            results {
               __typename
               id
               name
               ... on DesignItem {
                  id
                  name
                  tipRootModel {
                     id
                     component{
                        id
                     }
                  }
               }
            }
         }
      }
      
      Show More
    2. In the Query Variables Pane, enter the value of the projectId. To know how to obtain the projectId, refer to Retrieve Projects.

      Query Variables

      {
         "projectId": "urn:adsk.workspace:beta.project:584a6b4e-3fa8-4896-8895-3e8409c83092"
      }
      
    3. Click Play. A list of Items within a project is displayed in the response.

      Response

      {
         "data": {
            "itemsByProject": {
               "results": [
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:15v-Ak2HQSm_TqEX-mRa3Q",
                     "name": "AssyC",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-TzZhUEdkRzEyekhCYjZXWjd0YjVLNV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ34ycmI2VmR3VGZYM3BORlhIU3FsMkEwX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:2hDdlKgMTW-C-CnI7yrfXQ",
                     "name": "Test Box Component",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-ckJ3RHpxTlhnT0N0azQ5VEZWdGZTQl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35oMHVNRmgxbTRIaG43b3RBN3BLcWloX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:40Xab37ESMezjNh5zRE52w",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-Rzh0RWU4eDlNdHpKZlRoVmxLUjBrcV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35UbWdHUjBobWJkT3pxbmNlZUJWb3lEX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:7SzhCrFkT7q2wjEHX65wKw",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-THZTa2pGY0tIbWFiT2JkbWVSVzNYal9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ34zWkxiVmxsZEpmODlHZXFmSWFXY01UX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DrawingItem",
                     "id": "urn:adsk.wipstg:dm.lineage:8z0YKFZMS3mA_QQZ_79i9w",
                     "name": "Test Drawing"
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:A-dzvS_UQ_mF8SxN9As4ZQ",
                     "name": "Untitled3234213",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-aUh0c2ozeTNNQ3laYmNlM3B5ZWQ0d19hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35JUWgzdHlsNG40Q0hSeXBDTEFQVHJqX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:BM_bLl4YT3WDXkb3Q9os9Q",
                     "name": "Untitled3454354354q332",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-YzhoUTh2dHNHdGdycjdGNlJZU1g2UF9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ344UUhEUWQ2dzJ5c2FoZkhNZ2t1SmxJX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:HZx4hvNuSJmxlnexv_VhpQ",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-ekhYUzBKU05NUGJZUnVOdkF5NElWR19hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ34xYmtNZzhKbkVGb1FGMkNWRUs2Wlc2X2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:KMrqk70WS2uBeLbLF1hy_A",
                     "name": "AssyC",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-TllXSHV6NGZmTDJ3UDFoaHlVbXR0Ml9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ344RlNLTFhaRUp1N3pydVBkUmE3eVk3X2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:O4QH_er4RIi74Q8GPqR7SA",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-b1dBOWhEUEtESmV0U25EdWZZUjNyWV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35nd1hWaG03bnpsdGIzRHlZZFNhWm43X2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:S68Gmk_vQoOn30skgWdWEA",
                     "name": "UntitledBox123",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-bUFFZVhObUVpMVNzRUd3ZktCTG92MV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ343RjFaZzU1MG1SZm5yNXA3d0xUVGY3X2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:STvA0_jTRFe8Dz-20AFDIg",
                     "name": "Untitled14475",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-czBpVHI5MUJxNWlBdU11dEl5c21zd19hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ356UUNXOWZBamZEbXV2dVFYcFllUDFzX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:TMIwndZzSXuedUpORysmFw",
                     "name": "Rectangle",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-Z2U0YWNSWGE1d2owNk9DWG9VeTlUdV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ34xQmU1YVdZVVEzalV2WUZ2N0FxazJGX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:UNLDjdESQcmm1jCQ4Pxx4A",
                     "name": "1",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-dFpiaWdhWmFVYnFKdlBwa3R6dDJQNl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35qbW1jeWhJR0ZBM0I5U0c1YlRCYk1UX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:_X30eOmyTWGPUQRvcsublQ",
                     "name": "testData",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-czhFRVpFR2hqOEtrZjFRNmNTN2piOV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35JN1lVV1JwSGlva3ZsUHFEUHN3MXFNX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:aLOdpa7rQXux9B9mtnDYFQ",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-dDFJZzhEb1J1QVFjWVZ3VlJlZWFyTF9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ34wcVpWZnk4RXJSb3NtaGl3MEtWQlVmX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:bbpT2HNVTEm2W5boBjh1Hw",
                     "name": "FFF Bar support release",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-YnNWN295MDAzdk5zdGlPMmRVcGNYcl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35tTXQwajJGVnlSeURrTmFDZE5uZldTX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:f5-w0_VETq2nv6Nzvea01w",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-dlA0YnVxNEExMHNCdFpuWnNaeklIaF9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35vSGY2Mk81RGJtdmVvTWtjcUVLTlRQX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:fjXyAyI8QDmaPFvey0HtkQ",
                     "name": "UntitledCylinder",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-dTNOdTZTOXVhZXROWk4xTXAwV2twal9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35DZURJN3dneVcxdk9aaDdhQXI5MHdFX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:hBq90Lf1S0m_HqAmdk5JdQ",
                     "name": "Untitled1",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-Y1g2eWEyVk5xZUFPWGFwc21hY3ZWRV9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35vWU1VQm1hQW5Ed1pNTk1LNUZFd3lsX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:iRBDKIcVRn69_KTL9IQ9kQ",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-ZExkMk5tYnlkM1BhVERUeWpVd09xYl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35mNlNjWGpnQXFMREI5Q2YzczQ2NGZlX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:lZgxjqurTyCwqdye8swQPg",
                     "name": "Untitled",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-Rm96SGUzTExsT3EzZWpDNURwaWkxUF9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ35pY2M0aDd1WHlkdGpFWE4weXl2cHMyX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:vIVq-S-LTjixXhnFMz_FPA",
                     "name": "SphereTest",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-YnR2SmZybm1WaWl5R1h4Rkw2WW10bl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ354RUxNRjJ6QkNmOXVVaFl1bDJHWVZzX2FnYQ"
                        }
                     }
                  },
                  {
                     "__typename": "ConfiguredDesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:x70DNgVLTK2zDb0yZwX2iA",
                     "name": "Sphere"
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipstg:dm.lineage:xidHQz_jR5arquNThQq-FA",
                     "name": "WALKIE TALKIE v6",
                     "tipRootModel": {
                        "id": "bW9kZWx-d00wSVJmdmczT1VLTHZsYjJ4dDJMdF9MMkN-ald4c2F3Qmp5a1RRMmdMMmZkOUFKdl9hZ2E",
                        "component": {
                           "id": "cHJvZHVjdH53TTBJUmZ2ZzNPVUtMdmxiMnh0Mkx0X0wyQ340TmlrcXJQeEpITlZjRUFBcEdabmd1X2FnYQ"
                        }
                     }
                  }
               ]
            }
         },
         "extensions": {
            "pointValue": {
               "requestedQueryPointValue": 711
            }
         }
      }
      
      Show More

    Step 2 - Retrieve Items within a Folder

    The following steps demonstrate how you can run the itemsByFolder query to retrieve all the Items within a folder.

    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      query GetFolderItemsByFolder($hubId: ID!, $folderId: ID!) {
         itemsByFolder(hubId: $hubId, folderId: $folderId) {
            results {
               __typename
               id
               name
               ... on DesignItem {
                  id
                  name
                  rootComponent {
                     id
                     name
                  }
                  tipRootComponentVersion {
                     id
                     name
                  }
               }
            }
         }
      }
      
      Show More
    2. In the Query Variables Pane, enter the value of the hubId and folderId. To know how to obtain the hubId, refer to Retrieve Hubs.

      Query Variables

      {
         "hubId":    "urn:adsk.ace:prod.scope:42db5214-7dfe-431a-8275-2ea47d5686d5",
         "folderId": "urn:adsk.wipprod:fs.folder:co.neOeWDZ2THyEog4s2vqFQg"
      }
      
    3. Click Play. A list of Items within a folder is displayed in the response.

      Response

      {
         "data": {
            "itemsByFolder": {
               "results": [
                  {
                     "__typename": "ConfiguredDesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:3nKEsAAJRg2KuNLCl-UH5w",
                     "name": "ConfigTest"
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:AmkSu2iNRLiiELZQxAWhgQ",
                     "name": "Normal-Design-New",
                     "rootComponent": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnflRaTUxQclZ0Q1hqNmJvQXdsOWppc3FfYWdh",
                        "name": "Normal-Design-New"
                     },
                     "tipRootComponentVersion": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnflRaTUxQclZ0Q1hqNmJvQXdsOWppc3FfYWdhflRITEs5MzdJR3V5VXNUQkhuUVliTXA",
                        "name": "Normal-Design-New"
                     }
                  },
                  {
                     "__typename": "ConfiguredDesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:B_mqmfHXQ8-luAzgisFI3w",
                     "name": "design-for-model-occurence"
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:FgnbBe-JSm6g5jzE6xo1UA",
                     "name": "Normal-design-supergraph-test",
                     "rootComponent": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfmRBNHdycUk4ellBUGhRMWN3UDFmczNfYWdh",
                        "name": "Normal-design-supergraph-test"
                     },
                     "tipRootComponentVersion": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfmRBNHdycUk4ellBUGhRMWN3UDFmczNfYWdhfjVIRXcxRzRyRWJIR0FlZENrVzN5bDY",
                        "name": "Normal-design-supergraph-test"
                     }
                  },
                  {
                     "__typename": "ConfiguredDesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:SCdayUdRQZW7pkbfy9RpBQ",
                     "name": "Configured-Design"
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:Xbm07TlnTquPKdFrF756bg",
                     "name": "Normal-Design",
                     "rootComponent": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfkhxOThQSlYwMVVIVWZPUjdXaTA1elVfYWdh",
                        "name": "Normal-Design"
                     },
                     "tipRootComponentVersion": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfkhxOThQSlYwMVVIVWZPUjdXaTA1elVfYWdhflNZRHYyMUhPWmpzNmhZbWk1M0xQQlY",
                        "name": "Normal-Design"
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:_K20F311R-K-LaJ4VxPCtQ",
                     "name": "normalTEst",
                     "rootComponent": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfnljVjJEcGtQMVdKM1d3UnVRTmhCM3VfYWdh",
                        "name": "normalTEst"
                     },
                     "tipRootComponentVersion": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfnljVjJEcGtQMVdKM1d3UnVRTmhCM3VfYWdhfmZQQW54MWtzT3BSMWVDTXhRc3k2NE0",
                        "name": "normalTEst"
                     }
                  },
                  {
                     "__typename": "DesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:q_eTO0skS4yvFEJA6qSxpw",
                     "name": "main-design-for-model-occurence",
                     "rootComponent": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfko1RlJVYjBYbU1ieHdXVFBneG9PdXhfYWdh",
                        "name": "main-design-for-model-occurence"
                     },
                     "tipRootComponentVersion": {
                        "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnfko1RlJVYjBYbU1ieHdXVFBneG9PdXhfYWdhfndHdVVqdzNVbks2SGNXR2dTbWZKVjQ",
                        "name": "main-design-for-model-occurence"
                     }
                  },
                  {
                     "__typename": "ConfiguredDesignItem",
                     "id": "urn:adsk.wipprod:dm.lineage:rjwmFUfBTmGzq12GgYO4ig",
                     "name": "Configured-Design-New"
                  }
               ]
            }
         }
      }
      
      Show More

    Step 3 - Retrieve a Single Item

    When you already know an item’s ID, use the item query to retrieve just that one Item directly, without listing an entire project or folder. This is useful for refreshing a specific item or resolving it at a particular point in time or composition.

    The query requires a hubId and an itemId and accepts three optional arguments:

    • time (DateTime) - retrieves the item’s state at a specific point in time. Defaults to the current moment.
    • composition (ItemCompositionEnum) - the composition state used to traverse item relations: WORKING (default), RELEASED, AS_SAVED, or LATEST.
    • resolution (ItemResolutionEnum) - snaps the item to the most recent point in time prior or equal to time: DEFAULT (default) or GATED.
    1. Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.

      Query

      query GetItem(
         $hubId: ID!
         $itemId: ID!
         $composition: ItemCompositionEnum = WORKING
         $time: DateTime
      ) {
         item(hubId: $hubId, itemId: $itemId, composition: $composition, time: $time) {
            __typename
            id
            name
            timestamp
            composition
            createdOn
            lastModifiedOn
            ... on DesignItem {
               rootComponent {
                  id
                  name
               }
            }
         }
      }
      
      Show More
    2. In the Query Variables Pane, enter the value of the hubId and itemId. To know how to obtain the hubId, refer to Retrieve Hubs. The itemId is the id of any Item returned in Step 1 or Step 2.

      Query Variables

      {
         "hubId":  "urn:adsk.ace:prod.scope:42db5214-7dfe-431a-8275-2ea47d5686d5",
         "itemId": "urn:adsk.wipprod:dm.lineage:AmkSu2iNRLiiELZQxAWhgQ"
      }
      
    3. Click Play. The requested Item is displayed in the response.

      Response

      {
         "data": {
            "item": {
               "__typename": "DesignItem",
               "id": "urn:adsk.wipprod:dm.lineage:AmkSu2iNRLiiELZQxAWhgQ",
               "name": "Normal-Design-New",
               "timestamp": "2026-07-30T14:12:05.000Z",
               "composition": "WORKING",
               "createdOn": "2026-05-11T09:22:41.000Z",
               "lastModifiedOn": "2026-07-30T14:12:05.000Z",
               "rootComponent": {
                  "id": "Y29tcH5jby5uckdoR0ZIb1FXU3NQdFlhU0V2YThnflRaTUxQclZ0Q1hqNmJvQXdsOWppc3FfYWdh",
                  "name": "Normal-Design-New"
               }
            }
         }
      }
      
      Show More