Queries
itemVersion
Retrieves an object representing a version of an item.
Template for Query:
query GetItemVersion($hubId: ID!, $versionId: ID!) {
itemVersion(hubId: $hubId, versionId: $versionId) {
# ItemVersion Fields
}
}
Template for Query Variables:
{
"hubId" : "<SOME-ID-TYPE-SCALAR-VALUE>",
"versionId" : "<SOME-ID-TYPE-SCALAR-VALUE>"
}
Arguments
hubId* ID! non-null | The ID of the Hub that contains the item. |
versionId* ID! non-null | The ID of the basic item version to retrieve. |
* Required
Possible Returns
Value Type | Description |
---|---|
ItemVersion | Represents a version of an item. |
Examples
Example 1
This example retrieves information about a specific version of the design item.
Query:
query GetItemVersion($hubId: ID!, $itemId: ID!, $derivativeInput: DerivativeInput!) {
item(hubId: $hubId, itemId: $itemId) {
... on DesignItem {
id
name
tipRootComponentVersion {
id
derivatives(derivativeInput: $derivativeInput) {
id
signedUrl
status
outputFormat
}
}
}
}
}
Show More
Query Variables:
{
"hubId": "urn:adsk.ace:beta.scope:e7c7f5a9-a88a-40b4-85f6-ba1454def997",
"itemId": "urn:adsk.wipstg:dm.lineage:wmeheVeATLCveix-ZM35wA",
"derivativeInput": {
"generate": false,
"outputFormat": ["STEP"]
}
}
Show More
Response:
{
"data": {
"item": {
"id": "urn:adsk.wipstg:dm.lineage:wmeheVeATLCveix-ZM35wA",
"name": "Chair",
"tipRootComponentVersion": {
"id": "Y29tcH5WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ35HUWFjcVV1REdETnc5WlI5R1d1VDF4X2FnYX45UklONG1yeUJZZHY3VVJQUGxCME9z",
"derivatives": [
{
"id": "Y29tcH5WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ35HUWFjcVV1REdETnc5WlI5R1d1VDF4X2FnYX45UklONG1yeUJZZHY3VVJQUGxCME9z",
"signedUrl": "https://cdn-stg.derivative.autodesk.com/dXJuOmFkc2suZm9yZ2U6bDJhZy5hc3NldDpzdGc6R1FhY3FVdURHRE53OVpSOUdXdVQxeF9hZ2E_c25hcHNob3Q9OVJJTjRtcnlCWWR2N1VSUFBsQjBPcw/output/files/7ea684c6-2f17-408a-8ae4-7bd6b088a3c7/88a6abdd-b442-4f5b-aad1-314c10eb00bf.zip.stp?Policy=eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6Imh0dHBzOi8vY2RuLXN0Zy5kZXJpdmF0aXZlLmF1dG9kZXNrLmNvbS9kWEp1T21Ga2Myc3VabTl5WjJVNmJESmhaeTVoYzNObGREcHpkR2M2UjFGaFkzRlZkVVJIUkU1M09WcFNPVWRYZFZReGVGOWhaMkVfYzI1aGNITm9iM1E5T1ZKSlRqUnRjbmxDV1dSMk4xVlNVRkJzUWpCUGN3L291dHB1dC9maWxlcy83ZWE2ODRjNi0yZjE3LTQwOGEtOGFlNC03YmQ2YjA4OGEzYzcvODhhNmFiZGQtYjQ0Mi00ZjViLWFhZDEtMzE0YzEwZWIwMGJmLnppcC5zdHAiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3MjU5MDIxODl9fX1dfQ__&Key-Pair-Id=APKAJVJIJZ6OEYDPJSQA&Signature=IbWpn9MOzbQae9wGUa5Byhj9tErQwUMfoF~PfUAnQqrBjx68x4RW~BVYiNwc9PUlAoUxVyLgJaSYcsbTsKK0gTygMbO5N-H1BfowOkr3G4B2~3LqVNEeBKdsB7hmhv2h3JMW8uRWUhIPiVcWyD0qHuHgvmZjzkzUx7M3xeyiP16hxZXYwTqjUBE2Bkd-SzDrd8PAwZjgqTx64rRK1CpYLTG8eJwVBfHXftoJyGqa44sResL7L3J9PkH7FKb0mw5nWovTF5pjVQxq3ZF7zriBOe~GKgvzE0FqYbrOZrQVcBZsbO55ERIf8mouJVLxnFslU0FO~JLVFe4wqGyzCni-vw__",
"status": "SUCCESS",
"outputFormat": "STEP"
}
]
}
}
}
}
Show More
Example 2
Retrieves configured designItem version details.
Query:
query itemVersion($hubId: ID!, $itemVersionId: ID!) {
itemVersion(hubId: $hubId, versionId: $itemVersionId) {
id
name
... on ConfiguredDesignItemVersion {
__typename
configurationTable{
rows{
id
name
}
}
}
}
}
Show More
Query Variables:
{
"hubId": "urn:adsk.ace:beta.scope:e7c7f5a9-a88a-40b4-85f6-ba1454def997",
"itemVersionId": "urn:adsk.wipstg:fs.file:vf.LquRHj_ZQXuwSov5uvpVUw?version=4"
}
Response:
{
"data": {
"itemVersion": {
"id": "urn:adsk.wipstg:fs.file:vf.LquRHj_ZQXuwSov5uvpVUw?version=4",
"name": "CD_CYL",
"__typename": "ConfiguredDesignItemVersion",
"configurationTable": {
"rows": [
{
"id": "0b9e2251-6509-46e5-b8ed-71b591d1cdbc",
"name": "Configuration40_80"
},
{
"id": "4325bb58-97af-4948-8992-2c149e89e2bf",
"name": "Configuration42_80"
},
{
"id": "58c3765c-9b17-4c03-acc8-4873ffca9adb",
"name": "Configuration41_80"
}
]
}
}
}
}
Show More