FAIR Release Notes: 2.37.0

Summary

API Changes

This release contains a substantial change to the FAIR API, introducing a number of new GET endpoints for dataset metadata:

/datasets/{code}/catalogue

/datasets/{code}/dictionaries

/datasets/{code}/dictionaries/code

/datasets/{code}/dictionaries/code/fields

/datasets/{code}/dictionaries/code/lookups

/datasets/{code}/dictionaries/code/lookups/name/options

Our swagger docs have been updated to include these new endpoints and can be viewed here.

Prior to this change the GET datasets/{code} endpoint was the only means of returning the metadata associated with a particular dataset, this was causing loading issues in the FAIR UI when dataset had a large amount of associated metadata.

The new endpoints have been introduced as a first step toward building a more scalable dataset tab in FAIR which can handle a larger amount of metadata while maintaining a high level of performance.

API Integrations

The existing GET datasets endpoint is still available, and can continue to be used for existing integrations.

However, as part of the change we have also hardened the APIs use of wildcards in regular expressions, and while we do not believe this will impact any existing integrations we suggest that any customers that do integrate with the FAIR API test this before the release of FAIR 2.37 to production on 3 June 2025.

Vector Search

This release also includes the introduction of AI backed Azure Vector Search, this is disabled by default on all hubs but can be enabled at customer request. If you would like more information on this please contact your Customer Success Manager.

Released features