Table of contents
iTwins

Changelog

May 26, 2026

Added

Added operations for managing account settings.

  • Get account settings
  • Create account settings
  • Update account settings

Apr 6, 2026

Added

Added technology preview operations for global repositories.

  • Get global repositories
  • Get global repository
  • Get global repository resource
  • Get global repository resources
  • Get global resource graphics

Sep 3, 2025

Changed

Get Repository Resource and Get Repository Resources now support the return=representation option on the Prefer header, so callers can get all properties for the resource.

Aug 13, 2025

Added

Added technology preview operations for repository resources.

  • Create repository resource
  • Delete repository resource
  • Get repository
  • Get Repository Resource

Jul 15, 2025

Added

Added the technology preview Update iTwin Repository operation.

Jul 2, 2025

Added

Added the technology preview Get Repository Resources and Get Resource Graphics operations, and new properties to the Create iTwin Repository model.

  • displayName
  • capabilities
  • authorization
  • options

Oct 25, 2024

Changed

Added new properties to the iTwins model.

  • latitude
  • longitude
  • lastModifiedDateTime
  • lastModifiedBy

Oct 19, 2024

Changed

Added OData query parameters ($select, $filter, $orderby) to Get my iTwins, along with the X-Max-Return and X-iTwin-Query-Scope headers.

Oct 14, 2024

Added

Added technology preview operations for iTwin exports.

  • Create export
  • Get export
  • Get my exports

Oct 1, 2024

Changed

The subClass parameter is no longer required when querying for an iTwin — iTwins of all subclasses are returned if it's omitted. Multiple subclasses can also be specified as a comma-delimited string, e.g. subClass=Asset,Project.

May 14, 2024

Added

Added support for the external Subsurface class and EvoWorkspace subclass on the iTwin Repositories API, including support for an auto-generated SensorData service.

May 9, 2024

Added

Added the ianaTimeZone property to the iTwin model.

Dec 19, 2023

Added

Added the geographicLocation property to the iTwin model.

Aug 21, 2023

Added

Added the includeInactive parameter to all iTwin query APIs — set includeInactive=true to include inactive iTwins in query results.

Jul 27, 2023

Added

Added the ability to specify an image to use as an iTwin thumbnail.

  • Added the iTwins/{iTwinId}/image API to add/remove an iTwin image.
  • Added imageName and image properties to the iTwin.

Dec 5, 2022

Changed

The iTwin number is no longer required when creating a new iTwin — it defaults to the auto-generated iTwin ID if omitted or null. The iTwin displayName is also no longer required to be unique.

Nov 21, 2022

Added

Added support for account iTwins.

  • Added the iTwins/MyPrimaryAccount API.
  • Added the iTwins/{iTwinId}/Account API.
  • Added the iTwinAccountId property and query parameter.

Oct 31, 2022

Added

Added support for new iTwin subclasses.

  • Thing:Portfolio
  • Endeavor:Program
  • Endeavor:WorkPackage

Oct 11, 2022

Added

Added the parentId property to iTwins, allowing you to create a hierarchy of iTwins.

Aug 5, 2022

Announcement

Functionality for managing iTwins and iTwin repositories, and for recent and favorite iTwins, released in technology preview.

Was this page helpful?