Autodesk Fusion Items API

openapi: 3.2.0
info:
  title: Construction.Account.Admin Account Management Items API
  version: '1.0'
  contact:
    name: Autodesk Plaform Services
    url: https://aps.autodesk.com/
    email: aps.help@autodesk.com
  termsOfService: https://www.autodesk.com/company/legal-notices-trademarks/terms-of-service-autodesk360-web-services/forge-platform-web-services-api-terms-of-service
  x-support: https://stackoverflow.com/questions/tagged/autodesk-platform-services
  description: 'The Account Admin API automates creating and managing projects, assigning and managing project users, and managing member and partner company directories. You can also synchronize data with external systems.

    '
servers:
- url: https://developer.api.autodesk.com
security:
- 2-legged: []
- 3-legged: []
tags:
- name: Items
paths:
  /data/v1/projects/{project_id}/items/{item_id}:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItem
      summary: Get an Item
      description: 'Retrieves an item. Items represent Word documents, Fusion 360 design files, drawings, spreadsheets, etc.


        The tip version for the item is included in the included array of the payload.

        To retrieve multiple items, see the ListItems command.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      - $ref: '#/components/parameters/includePathInProject'
      responses:
        '200':
          description: The specified item was retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Item'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
    patch:
      tags:
      - Items
      operationId: patchItem
      summary: Update an Item
      description: 'Updates the ``displayName`` of the specified item. Note that updating the ``displayName`` of an item is not supported for BIM 360 Docs or ACC items.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      responses:
        '200':
          description: Updated the item’s properties successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Item'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
        '423':
          $ref: '#/components/responses/423-general'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/ModifyItemPayload'
        description: Describe the item to be patched.
      security:
      - 2-legged:
        - data:write
      - 3-legged:
        - data:write
  /data/v1/projects/{project_id}/items/{item_id}/parent:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemParentFolder
      summary: Get Parent of an Item
      description: 'Returns the parent folder of the specified item.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      responses:
        '200':
          description: The parent folder was retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folder'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
  /data/v1/projects/{project_id}/items/{item_id}/relationships/refs:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemRelationshipsRefs
      summary: List Custom Relationships for an Item
      description: 'Returns the custom relationships that are associated with the specified item. Custom relationships can be established between an item and other resources within the ``data`` domain service (folders, items, and versions).


        Each relationship is defined by the ID of the object at the other end of the relationship, together with type, specific reference meta including extension data.

        Callers will typically use a filter parameter to restrict the response to the custom relationship types (``filter[meta.refType]``) they are interested in.

        The response body will have an included array that contains the resources in the relationship, which is essentially what is returned by the [List Related Resources for an Item](/en/docs/data/v2/reference/http/projects-project_id-items-item_id-refs-GET/) operation.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      - $ref: '#/components/parameters/filter_type_version'
      - $ref: '#/components/parameters/filter_id'
      - $ref: '#/components/parameters/filter_refType'
      - $ref: '#/components/parameters/filter_direction'
      - $ref: '#/components/parameters/filter_extension_type'
      responses:
        '200':
          description: The list of custom relationships was successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelationshipRefs'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
    post:
      tags:
      - Items
      operationId: createItemRelationshipsRef
      summary: Create a Custom Relationship for an Item
      description: Creates a custom relationship between an item and another resource within the data domain service (folder, item, or version).
      security:
      - 2-legged:
        - data:create
      - 3-legged:
        - data:create
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      responses:
        '204':
          description: A custom relationship for the item was successfully created.
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/RelationshipRefsPayload'
        description: ''
  /data/v1/projects/{project_id}/items/{item_id}/refs:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemRefs
      summary: List Related Resources for an Item
      description: 'Returns the resources (items, folders, and versions) that have a custom relationship with the specified item. Custom relationships can be established between an item and other resources within the data domain service (folders, items, and versions).



        Each relationship is defined by the ID of the object at the other end of the relationship, together with type, attributes, and relationships links.

        Callers will typically use a filter parameter to restrict the response to the custom relationship types (``filter[meta.refType]``) they are interested in.



        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      - $ref: '#/components/parameters/filter_type_version'
      - $ref: '#/components/parameters/filter_id'
      - $ref: '#/components/parameters/filter_extension_type'
      responses:
        '200':
          description: The list of related resources was successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refs'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          description: Forbidden
        '404':
          $ref: '#/components/responses/404-general'
  /data/v1/projects/{project_id}/items/{item_id}/relationships/links:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemRelationshipsLinks
      summary: List Relationship Links for an Item
      description: "Returns a list of links for the specified item. \n\nCustom relationships can be established between an item and other external resources residing outside the data domain service. A link’s ``href`` attribute defines the target URI to access a resource.\n\n**Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). "
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      responses:
        '200':
          description: The relationship links for the item were retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelationshipLinks'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
  /data/v1/projects/{project_id}/items/{item_id}/tip:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemTip
      summary: Get Tip Version of an Item
      description: 'Returns the latest version of the specified item. A project can contain multiple versions of a resource item. The latest version is referred to as the tip version, which is returned by this operation.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      responses:
        '200':
          description: The tip version of the item was retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ItemTip'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
  /data/v1/projects/{project_id}/items/{item_id}/versions:
    parameters:
    - $ref: '#/components/parameters/project_id'
    - $ref: '#/components/parameters/item_id'
    get:
      tags:
      - Items
      operationId: getItemVersions
      summary: List all Versions of an Item
      description: 'Lists all versions of the specified item. A project can contain multiple versions of a resource item.


        **Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). '
      security:
      - 2-legged:
        - data:read
      - 3-legged:
        - data:read
      parameters:
      - $ref: '#/components/parameters/x-user-id'
      - $ref: '#/components/parameters/filter_id'
      - $ref: '#/components/parameters/filter_extension_type'
      - $ref: '#/components/parameters/filter_versionNumber'
      - $ref: '#/components/parameters/page_number'
      - $ref: '#/components/parameters/page_limit'
      responses:
        '200':
          description: All versions of the specified item were successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Versions'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
  /data/v1/projects/{project_id}/items:
    parameters:
    - $ref: '#/components/parameters/project_id'
    post:
      tags:
      - Items
      operationId: createItem
      summary: Create an Item
      description: "Creates the first version of a file (item). To create additional versions of an item, use POST versions.\n\nBefore you create the first version of an item, you must create a placeholder for the file, and upload the file to the placeholder. For more details about the workflow, see the tutorial on uploading a file.\n\nThis operation also allows you to create a new item by copying a specific version of an existing item to another folder. The copied version becomes the first version of the new item in the target folder.\n\n**Note:** You cannot copy versions of items across different projects and accounts.\n\nUse the [Create Version](/en/docs/data/v2/reference/http/projects-project_id-versions-POST/) operation with the ``copyFrom`` parameter if you want to create a new version of an item by copying a specific version of another item. \n\nBefore you use the Data Management API to access BIM 360 Docs files, you must provision your app through the BIM 360 Account Administrator portal. For details, see the [Manage Access to Docs tutorial](/en/docs/bim360/v1/tutorials/getting-started/manage-access-to-docs/).\n\n**Note:** This operation supports Autodesk Construction Cloud (ACC) Projects. For more information, see the [ACC Platform API documentation](https://en.docs.acc.v1/overview/introduction/). "
      security:
      - 2-legged:
        - data:create
      - 3-legged:
        - data:create
      parameters:
      - $ref: '#/components/parameters/copyFrom'
      - schema:
          type: string
        in: query
        name: x-user-id
        description: "In a two-legged authentication context, the app has access to all users specified by the administrator in the SaaS integrations UI. By providing this header, the API call will be limited to act on behalf of only the user specified.        \n\nNote that for a three-legged OAuth flow or for a two-legged OAuth flow with user impersonation (``x-user-id``), the users of your app must have permission to upload files to the specified parent folder (``data.attributes.relationships.parent.data.id``).\n\nFor copying files, users of your app must have permission to view the source folder. \n\nFor information about managing and verifying folder permissions for BIM 360 Docs, see the section on [Managing Folder Permissions](http://help.autodesk.com/view/BIM360D/ENU/?guid=GUID-2643FEEF-B48A-45A1-B354-797DAD628C37).'\n"
      responses:
        '201':
          description: The first version of an item was successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatedItem'
        '400':
          $ref: '#/components/responses/400-general'
        '403':
          $ref: '#/components/responses/403-general'
        '404':
          $ref: '#/components/responses/404-general'
        '409':
          $ref: '#/components/responses/409-general'
        '423':
          $ref: '#/components/responses/423-general'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/ItemPayload'
        description: ''
components:
  schemas:
    json_api_version_value:
      description: The version of JSON API. Will always be ``1.0``.
      type: string
      enum:
      - '1.0'
    json_api_links_self:
      title: json_api_links_self
      x-stoplight:
        id: hedbm6v3pcz7k
      type: object
      description: An object containing the URI of the endpoint to access this resource.
      properties:
        self:
          type: object
          x-stoplight:
            id: xjz8a6shpmaya
          description: An object containing the URI of the endpoint to access this resource.
          properties:
            href:
              type: string
              x-stoplight:
                id: jx2lmnxrl8f10
              description: "The URI of the endpoint to access this \nresource."
    type_folder:
      type: string
      enum:
      - folders
      description: The type of the resource. Possible values are ``folders``.
    metaForWebhooks:
      title: metaForWebhooks
      x-stoplight:
        id: x20x6jb3udvzo
      type: object
      description: Meta information required for webhooks.
      properties:
        workflow:
          type: string
          description: "The Workflow ID of a webhook that listens to Model Derivative events. Must be less than 36 characters. \nOnly ASCII characters (a-z, A-Z, 0-9), periods (.), and hyphens (-) are accepted.\nSee the [Creating a Webhook and Listening to Events](/en/docs/webhooks/v1/tutorials/create-a-hook-model-derivative) tutorial for more information.\n\n**Note**: This attribute applies to BIM 360 Docs only.\n"
        workflowAttribute:
          type: string
          description: "A user defined JSON object containing custom workflow information for the specified webhook event. Must be less than 1KB.\n\n**Note**: Applicable only if a valid value has been specified for ``meta.workflow``. \n"
      required:
      - workflow
    Refs:
      description: Successful retrieval of a resource collection.
      type: object
      x-examples:
        example-1:
          jsonapi:
            version: '1.0'
          links:
            self:
              href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/refs
          data:
          - type: versions
            id: urn:adsk.wipprod:fs.file:vf.b909RzMKR4mhc3O7UBY_8g?version=2
            attributes:
              name: version-test.pdf
              displayName: version-test.pdf
              createTime: '2016-04-01T11:12:35.000Z'
              createUserId: BW9RM76WZBGL
              createUserName: John Doe
              lastModifiedTime: '2016-04-01T11:15:22.000Z'
              lastModifiedUserId: BW9RM76WZBGL
              lastModifiedUserName: John Doe
              versionNumber: 2
              mimeType: application/pdf
              extension:
                type: versions:autodesk.bim360:File
                version: '1.0'
                schema:
                  href: /schema/v1/versions/versions%3Aautodesk.bim360%3AFile-1.0
                data:
                  tempUrn: null
                  properties: {}
                  storageUrn: urn:adsk.objects:os.object:wip.dm.prod/9f8bdc3f-e29c-4ada-ab7b-bb8dfa821163.pdf
                  storageType: OSS
                  conformingStatus: NONE
            links:
              self:
                href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D2
            relationships:
              item:
                links:
                  related:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/items/urn%3Aadsk.wipprod%3Adm.lineage%3Ab909RzMKR4mhc3O7UBY_8g
                data:
                  type: items
                  id: urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g
              refs:
                links:
                  self:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D2/relationships/refs
                  related:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D2/refs
              links:
                links:
                  self:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D2/relationships/links
              storage:
                meta:
                  link:
                    href: /oss/v2/buckets/wipbucket/objects/9f8bdc3f-e29c-4ada-ab7b-bb8dfa821163.pdf?scopes=b360project.6f8813fe-31a7-4440-bc63-d8ca97c856b4,global,O2tenant.tenantId
                data:
                  type: objects
                  id: urn:adsk.objects:os.object:wip.dm.prod/9f8bdc3f-e29c-4ada-ab7b-bb8dfa821163.pdf
          - type: versions
            id: urn:adsk.wipprod:fs.file:vf.b909RzMKR4mhc3O7UBY_8g?version=1
            attributes:
              name: version-test.pdf
              displayName: version-test.pdf
              createTime: '2016-04-01T11:09:03.000Z'
              createUserId: BW9RM76WZBGL
              createUserName: John Doe
              lastModifiedTime: '2016-04-01T11:11:18.000Z'
              lastModifiedUserId: BW9RM76WZBGL
              lastModifiedUserName: John Doe
              versionNumber: 1
              mimeType: application/pdf
              extension:
                type: versions:autodesk.bim360:File
                version: '1.0'
                schema:
                  href: /schema/v1/versions/versions%3Aautodesk.bim360%3AFile-1.0
                data:
                  tempUrn: null
                  properties: {}
                  storageUrn: urn:adsk.objects:os.object:wip.dm.prod/3c8f6bbc-fe5c-4815-a92e-8b8635e7b1cb.pdf
                  storageType: OSS
                  conformingStatus: NONE
            links:
              self:
                href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D1
            relationships:
              item:
                links:
                  related:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/items/urn%3Aadsk.wipprod%3Adm.lineage%3Ab909RzMKR4mhc3O7UBY_8g
                data:
                  type: items
                  id: urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g
              refs:
                links:
                  self:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D1/relationships/refs
                  related:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D1/refs
              links:
                links:
                  self:
                    href: /data/v1/projects/b.6f8813fe-31a7-4440-bc63-d8ca97c856b4/versions/urn%3Aadsk.wipprod%3Afs.file%3Avf.b909RzMKR4mhc3O7UBY_8g%3Fversion%3D1/relationships/links
              storage:
                meta:
                  link:
                    href: /oss/v2/buckets/wipbucket/objects/3c8f6bbc-fe5c-4815-a92e-8b8635e7b1cb.pdf?scopes=b360project.6f8813fe-31a7-4440-bc63-d8ca97c856b4,global,O2tenant.tenantId
                data:
                  type: objects
                  id: urn:adsk.objects:os.object:wip.dm.prod/3c8f6bbc-fe5c-4815-a92e-8b8635e7b1cb.pdf
          - type: items
            id: urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g
            attributes:
              displayName: version-test.pdf
              createTime: '2016-04-01T11:09:03.000Z'
              createUserId: BW9RM76WZBGL
              createUserName: John Doe
              lastModifiedTime: '2016-04-01T11:11:18.000Z'
              lastModifiedUserId: BW9RM76WZBGL
              lastModifiedUserName: John Doe
              hidden: false
              reserved: true
              reservedTime: '2016-04-01T11:10:20.000Z'
              reservedUserId: BW9RM76WZBGL
              reservedUserName: John Doe
              extension:
                data: {}
                version: '1.0'
                type: items:autodesk.bim360:File
                schema:
                  href: https://developer.api.autodesk.com/schema/v1/versions/items%3Aautodesk.bim360%3AFile-1.0
            relationships:
              tip:
                data:
                  type: versions
                  id: urn:adsk.wipprod:fs.file:vf.b909RzMKR4mhc3O7UBY_8g?version=2
                links:
                  related:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn%3Aadsk.wipprod%3Adm.lineage%3AhC6k4hndRWaeIVhIjvHu8w/tip
              parent:
                data:
                  type: folders
                  id: urn:adsk.wipprod:dm.folder:sdfedf8wefl
                links:
                  related:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/parent
              versions:
                links:
                  related:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/versions
              refs:
                links:
                  self:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/relationships/refs
                  related:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/refs
              links:
                links:
                  self:
                    href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g/relationships/links
            links:
              self:
                href: /data/v1/projects/a.ZXhhbXBsZTp3aXAxZnFhYXV0b2Rlc2sxNjEjMjAyMzAzMTcwMDAwMDAx/items/urn:adsk.wipprod:dm.lineage:b909RzMKR4mhc3O7UBY_8g
      title: Refs
      properties:
        jsonapi:
          $ref: '#/components/schemas/json_api_version'
        links:
          $ref: '#/components/schemas/json_api_links_self'
        data:
          x-stoplight:
            id: zlvce0hljvqwg
          description: An array of objects, where each object represents a referenced resource (folder, item, or version).
          type: array
          items:
            x-stoplight:
              id: cy4i92ra7cxpr
            oneOf:
            - $ref: '#/components/schemas/FolderData'
              x-stoplight:
                id: rtffmltt1v80u
            - $ref: '#/components/schemas/ItemData'
              x-stoplight:
                id: kmkkve99132f1
            - $ref: '#/components/schemas/VersionData'
              x-stoplight:
                id: qqyd7tqmmhicv
            discriminator:
              propertyName: type
              mapping:
                folders: '#/components/schemas/FolderData'
                items: '#/components/schemas/ItemData'
                versions: '#/components/schemas/VersionData'
      required:
      - jsonapi
      - links
      - data
    version_extension_with_schema_link:
      type: object
      description: A container of additional properties that extends the default properties of a version.
      properties:
        type:
          type: string
          description: The Type ID of the schema that defines the structure of the ``extension.data`` object.
        version:
          type: string
          description: The version of the schema that applies to the ``extension.data`` object.
        schema:
          $ref: '#/components/schemas/json_api_link'
        data:
          type: object
          description: The object that contains the additional properties, which makes this resource extensible.
          additionalProperties:
            type: object
            description: 'Key-value pairs that contain the name and data of additional properties.

              '
      required:
      - type
      - version
      - schema
      title: ''
    json_api_relationships_refs:
      type: object
      description: 'Information on other resources that share a custom relationship with this resource.

        '
      properties:
        data:
          type: array
          description: 'An array of objects, where each object represents custom relationship. '
          items:
            minItems: 1
            type: object
            properties:
              type:
                $ref: '#/components/schemas/type_version'
              id:
                type: string
                description: 'A URN indicating the storage location of the version.

                  '
              meta:
                type: object
                description: The meta-information describing the custom relationship.
                required:
                - refType
                - direction
                - extension
                properties:
                  refType:
                    $ref: '#/components/schemas/reftypes_xref'
                  direction:
                    $ref: '#/components/schemas/metarefs_direction'
                  extension:
                    type: object
                    description: A container of additional properties that extends the default properties of this resource.
                    required:
                    - type
                    - version
                    properties:
                      type:
                        $ref: '#/components/schemas/extension_type_core_xref'
                      version:
                        type: string
                        description: 'The version of the type. The current version is ``1.1.0``.

                          '
                      data:
                        type: object
                        description: 'The container of the additional properties.


                          The additional properties must follow the schema specified by ``extensions.type`` and ``extensions.version``. Properties that don''t follow the schema will be ignored.'
                        properties:
                          nestedType:
                            $ref: '#/components/schemas/nested_xref'
                        required:
                        - nestedType
            required:
            - type
            - id
            - meta
      required:
      - data
    nested_xref:
      type: string
      x-stoplight:
        id: e8d7c1f07c607
      enum:
      - attachment
      - overlay
      description: 'The type of the xref, which defines how nested xrefs are handled. Possible values are:


        -  ``attachment``: Nested xrefs are not ignored.

        -  ``overlay`` : Nested xrefs are ignored.'
    filter_refType:
      type: string
      enum:
      - derived
      - dependencies
      - auxiliary
      - xrefs
      - includes
      description: 'Filter by ``refType``. Possible values: ``derived``, ``dependen

# --- truncated at 32 KB (122 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/autodesk-fusion/refs/heads/main/openapi/autodesk-fusion-items-api-openapi.yml