Versions

Definition

Publically avaliable instances of the Taxonomy.

Description

Versions in the Taxonomy are expressed as integers, starting at 1. For current Taxonomy version, see Querying Taxonomy versions below.

Versions are not tied to certain types of changes. Any change, such as the adding and deprecating of concepts, as well as updating of labels and relations, etc., may occur in each new version: all versions are "major" in this sense.

For a comprehensive look at changes that have occurred in each previous Taxonomy version, see the taxonomy version history repo.

New versions of the Taxonomy are published roughly every third month, but with no set frequency.

Querying Taxonomy versions

A list containing all published Taxonomy versions can be found through:

curl -X 'GET' \
  'https://taxonomy.api.jobtechdev.se/v1/taxonomy/main/versions' \
  -H 'accept: application/json'

Or simply:

https://taxonomy.api.jobtechdev.se/v1/taxonomy/main/versions

The last item in the list is the most recently published version.

A Taxonomy query can be parameterized with a specific version if needed, for instance:

query MyQuery {
  concepts(type: "occupation-name", version: 2) {
    id
    preferred_label
    type
  }
}

When the version parameter is omitted, the response defaults to the one most recently published.