item
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. |
| time | The timestamp to retrieve the item state at a specific point in time. |
| composition | The composition state used to traverse item relations. |
| resolution | Snaps the Item at a most recent point in time prior or equal to the time parameter. |
Possible Returns
| Value Type | Description |
|---|---|
| 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
}
}
}
}
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"
}
}
}
}
}
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
}
}
}
}
}
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"
}
]
}
}
}
}
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
}
}
}
}
}
}
}
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"
}
]
}
}
]
}
}
}
}
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
}
}
}
}
}
}
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"
}
]
}
}
}
}
}
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
}
}
}
}
}
}
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"
}
}
}
}
}
}
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
}
}
}
}
}
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"
}
]
}
}
}
}
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
}
}
}
}
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"
}
}
}
}