Request

Response

    Queries

    drawingVersion

    query

    Retrieves an object representing a version of a drawing.

    Drawings contain 2D projected views of designs.

    Template for Query:

    query GetDrawingVersion($drawingVersionId: ID!) {
      drawingVersion(drawingVersionId: $drawingVersionId) {
        # DrawingVersion Fields
      }
    }
    

    Arguments

    drawingVersionId*
    ID! non-null
    The ID of the drawing version to fetch.
    * Required

    Possible Returns

    Value TypeDescription
    DrawingVersion Represents a version of a 2D drawing that contains projected views of a version of a component.


    Examples

    Example 1

    Retrieves a version of a drawing along with the drawing item’s and component’s version it belongs to, its thumbnail and its un-versioned drawing.

    Query:

    query GetDrawingVersion($drawingVersionId: ID!) {
           drawingVersion(drawingVersionId: $drawingVersionId) {
               id
               name
               drawing {
                   id
               }
               drawingItemVersion {
                   id
               }
               componentVersion {
                   id
                   name
               }
               thumbnail {
                   status
                   signedUrl
               }
               drawing {
                   id
                   name
               }
       }
     }
    
    Show More

    Query Variables:

    {
     "drawingVersionId": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYX44a2JrNE5pcTY2bGZ6UXRwUk9aTjlw"
    }
    

    Response:

    {
       "data": {
           "drawingVersion": {
               "id": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYX44a2JrNE5pcTY2bGZ6UXRwUk9aTjlw",
               "name": "3D_Arm_Scan Drawing",
               "drawing": {
                   "id": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYQ",
                   "name": "3D_Arm_Scan Drawing"
               },
               "drawingItemVersion": {
                   "id": "urn:adsk.wipstg:fs.file:vf.xg_7JjcHRvqHQuSuCBiykQ?version=1"
               },
               "componentVersion": {
                   "id": "Y29tcH5WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ34zMlBTQ2daMXJLY2V3SHlCN1dkbEZyX2FnYX53RnlaU1BGSmNQY2l3NDdFeTBIemJX",
                   "name": "3D_Arm_Scan"
               },
               "thumbnail": {
                   "status": "SUCCESS",
                   "signedUrl": "https://cdn-stg.derivative.autodesk.com/dXJuOmFkc2sud2lwc3RnOmZzLmZpbGU6dmYueGdfN0pqY0hSdnFIUXVTdUNCaXlrUT92ZXJzaW9uPTE/output/256x256.png?Policy=eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6Imh0dHBzOi8vY2RuLXN0Zy5kZXJpdmF0aXZlLmF1dG9kZXNrLmNvbS9kWEp1T21Ga2Myc3VkMmx3YzNSbk9tWnpMbVpwYkdVNmRtWXVlR2RmTjBwcVkwaFNkbkZJVVhWVGRVTkNhWGxyVVQ5MlpYSnphVzl1UFRFL291dHB1dC8yNTZ4MjU2LnBuZyoiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3MjU5MDIyMTN9fX1dfQ__&Key-Pair-Id=APKAJVJIJZ6OEYDPJSQA&Signature=FX2JxVyVWZqYS-F-RwuidCdUUgBl9L~H4DI5un7SMEijc-ShA~B3BAJ5x53d9QvwRFYnmhduIEx1C5qLZuwkNdJxoo8mI~JVWOdLlZznNycguN7~4TuSJM1UowSxu-ZrvOFMNJFemqfsyvQ7tKLiv6cZFUT1fWmu4ERj-Kt8X~9SpFw2o2z8p~weeOzpIgi7Qw7LEyitsRccHFI-7FTiwJUFfakSqfRLmb8AVoPsBalXyHmIP2yA8mkieH~gEyAwlSKhuGBkWuPqGkncMGzBiKcIzWUCjDdzgvEXoGbIOv2NGI35twbVMfAfTYrpiLu3lq-5GydqLzXuhhoLpYVOpw__"
               }
           }
       }
    }
    
    Show More

    Example 2

    Retrieve the version of the design item that corresponds to the drawing version representing its 2D view.

    Query:

    query GetDrawingVersion($drawingVersionId: ID!) {
           drawingVersion(drawingVersionId: $drawingVersionId) {
               id
               name
               drawing {
                   id
               }
               drawingItemVersion {
                   id
                   designItemVersion{
                       id
                       name
                   }
               }
           }
         }
    
    Show More

    Query Variables:

    {
     "drawingVersionId": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYX44a2JrNE5pcTY2bGZ6UXRwUk9aTjlw"
    }
    

    Response:

    {
       "data": {
           "drawingVersion": {
               "id": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYX44a2JrNE5pcTY2bGZ6UXRwUk9aTjlw",
               "name": "3D_Arm_Scan Drawing",
               "drawing": {
                   "id": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ344SkNrWE1nMDkxNDV2bXpvdWRXRmF2X2FnYQ"
               },
               "drawingItemVersion": {
                   "id": "urn:adsk.wipstg:fs.file:vf.xg_7JjcHRvqHQuSuCBiykQ?version=1",
                   "designItemVersion": {
                       "id": "urn:adsk.wipstg:fs.file:vf.2T9wT3rFSZW0SJkfo139PQ?version=1",
                       "name": "3D_Arm_Scan"
                   }
               }
           }
       }
    }
    
    Show More

    Example 3

    Retrieves Properties associated with the DrawingVersion.

    Query:

    query GetDrawingVersionProperties($drawingVersionId: ID!) {
           drawingVersion(drawingVersionId: $drawingVersionId) {
               id
               name
               customProperties {
                   results {
                       value
                       displayValue
                       definition {
                           id
                           name
                           specification
                           isHidden
                           isReadOnly
                           isArchived
                           description
                           propertyBehavior
                           units {
                               id
                               name
                           }
                       }
                   }
               }
           }
     }
    
    Show More

    Query Variables:

    {
     "drawingVersionId": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ35UZm85djhzUmtib1IyaGpKemhpVHlqX2FnYX5pRHZBbDh2VHdsQktyandxaWZnU1g0"
    }
    

    Response:

    {
       "data": {
           "drawingVersion": {
               "id": "ZHJhd35WQVZNUW1sYmxrZDBtaXJwU0NYMHJ0X0wyQ35UZm85djhzUmtib1IyaGpKemhpVHlqX2FnYX5pRHZBbDh2VHdsQktyandxaWZnU1g0",
               "name": "Connector Joint Drawing",
               "customProperties": {
                   "results": [
                       {
                           "value": 10.12,
                           "displayValue": "10.12",
                           "definition": {
                               "id": "cHJvcGRlZn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5wcm9wX2RlZl9jb2xfMTcwNzM3NjE0MTM1N35wYXJhbWV0ZXJzLkNmWG9hQzRLNTNTVHdiNlRuSXJYWFpUQUlFZGRHOUFyOjUzNGU2MDI0OWEwZDRjYzBhZGQ5YWU2ZmIyZjY1NzlhLTEuMC4w",
                               "name": "material length",
                               "specification": "FLOAT",
                               "isHidden": false,
                               "isReadOnly": false,
                               "isArchived": false,
                               "description": "description",
                               "propertyBehavior": "DYNAMIC_AT_VERSION",
                               "units": null
                           }
                       },
                       {
                           "value": "10D123E001",
                           "displayValue": "10D123E001",
                           "definition": {
                               "id": "cHJvcGRlZn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5wcm9wX2RlZl9jb2xfMTcwNzM3NjE0MTM1N35wYXJhbWV0ZXJzLkNmWG9hQzRLNTNTVHdiNlRuSXJYWFpUQUlFZGRHOUFyOmJiN2JlZDVkOTFhMTQxY2I5YmY0Nzc4OTA0MTMwYWVmLTEuMC4w",
                               "name": "ERP ID",
                               "specification": "STRING",
                               "isHidden": false,
                               "isReadOnly": false,
                               "isArchived": false,
                               "description": "description",
                               "propertyBehavior": "TIMELESS",
                               "units": null
                           }
                       },
                       {
                           "value": 10,
                           "displayValue": "10",
                           "definition": {
                               "id": "cHJvcGRlZn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5wcm9wX2RlZl9jb2xfMTcwNzM3NjE0MTM1N35wYXJhbWV0ZXJzLkNmWG9hQzRLNTNTVHdiNlRuSXJYWFpUQUlFZGRHOUFyOjU4ODExNjVkYTFjYTQxYTZhZDEwZTRiY2MyZWNkOTU2LTEuMC4w",
                               "name": "supplier cost",
                               "specification": "INTEGER",
                               "isHidden": false,
                               "isReadOnly": false,
                               "isArchived": false,
                               "description": "description",
                               "propertyBehavior": "DYNAMIC",
                               "units": null
                           }
                       }
                   ]
               }
           }
       }
    }
    
    Show More