Windchill REST Services supports versioning of the APIs provided by a domain. The domain configurations are defined in version specific folders, such as, v1, v2, v3, and so on. The default version that must be used for the domains is set by the defaultVersion property in the <Domain JSON File>. Generally, the default version is set to the latest version of the domain.

Clients can request a specific version of a domain resource in the URL. For example, the URL to request version 1 of the Product Management domain is:

Alternately, the version can be specified in the Accept header of the HTTP request. For example, to request version 1 of the Product Management domain use the URL:

Specify the version in the Accept header as:

If you want to use a previous version of the domain in your application, specify the version of the domain in the HTTP request. This ensures backward compatibility of your applications. It is recommended to use the latest version of the domain to take advantage of the latest features. However, with the latest domain version backward compatibility may be lost.

If you do not request a specific domain version in your HTTP request, the default version set by defaultVersion property is returned. To use the default version of the domain, do not specify the version in the URL or Accept header.