Get Employee adoption metrics

curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    {
      "query_id": "query-id",
      "filters": [
        {
          "filter": "attribute",
          "attribute_name": "organisational_unit",
          "operator": "eq",
          "attribute_value": "abc-123"
        }
      ]
    }
  ]
}
'

import requests

url = "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics"

payload = { "queries": [
        {
            "query_id": "query-id",
            "filters": [
                {
                    "filter": "attribute",
                    "attribute_name": "organisational_unit",
                    "operator": "eq",
                    "attribute_value": "abc-123"
                }
            ]
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    queries: [
      {
        query_id: 'query-id',
        filters: [
          {
            filter: 'attribute',
            attribute_name: 'organisational_unit',
            operator: 'eq',
            attribute_value: 'abc-123'
          }
        ]
      }
    ]
  })
};

fetch('https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'queries' => [
        [
                'query_id' => 'query-id',
                'filters' => [
                                [
                                                                'filter' => 'attribute',
                                                                'attribute_name' => 'organisational_unit',
                                                                'operator' => 'eq',
                                                                'attribute_value' => 'abc-123'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics"

	payload := strings.NewReader("{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "query_id": "query-123-abc",
      "metrics": {
        "domains": [
          {
            "domain_name": "IT",
            "external_id": "abdcde-domain",
            "skill_clusters": [
              {
                "external_id": "abdcde-cluster",
                "skill_cluster_name": "Software Engineering",
                "skills": [
                  {
                    "skill_id": "abcde-skill-1",
                    "skill_name": "Automated Testing",
                    "unique_employee_count": 10
                  }
                ],
                "sum_employee_skill_count": 10,
                "unique_employee_count": 10,
                "unique_skill_count": 1
              }
            ],
            "sum_employee_skill_count": 10,
            "unique_employee_count": 10,
            "unique_skill_count": 1
          }
        ],
        "skills_outside_taxonomy": {
          "skills": [
            {
              "skill_id": "abcde-skill-2",
              "skill_name": "Software Debugging",
              "unique_employee_count": 5
            }
          ],
          "sum_employee_skill_count": 5,
          "unique_employee_count": 5,
          "unique_skill_count": 1
        },
        "sum_employee_skill_count": 15,
        "unique_employee_count": 15,
        "unique_skill_count": 2,
        "total_employee_skill_count": 15
      }
    }
  ]
}

Get Employee adoption metrics

curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    {
      "query_id": "query-id",
      "filters": [
        {
          "filter": "attribute",
          "attribute_name": "organisational_unit",
          "operator": "eq",
          "attribute_value": "abc-123"
        }
      ]
    }
  ]
}
'

import requests

url = "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics"

payload = { "queries": [
        {
            "query_id": "query-id",
            "filters": [
                {
                    "filter": "attribute",
                    "attribute_name": "organisational_unit",
                    "operator": "eq",
                    "attribute_value": "abc-123"
                }
            ]
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    queries: [
      {
        query_id: 'query-id',
        filters: [
          {
            filter: 'attribute',
            attribute_name: 'organisational_unit',
            operator: 'eq',
            attribute_value: 'abc-123'
          }
        ]
      }
    ]
  })
};

fetch('https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'queries' => [
        [
                'query_id' => 'query-id',
                'filters' => [
                                [
                                                                'filter' => 'attribute',
                                                                'attribute_name' => 'organisational_unit',
                                                                'operator' => 'eq',
                                                                'attribute_value' => 'abc-123'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics"

	payload := strings.NewReader("{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant_name}.{region}.techwolf.ai/employees/metrics/adoption_metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"queries\": [\n    {\n      \"query_id\": \"query-id\",\n      \"filters\": [\n        {\n          \"filter\": \"attribute\",\n          \"attribute_name\": \"organisational_unit\",\n          \"operator\": \"eq\",\n          \"attribute_value\": \"abc-123\"\n        }\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "query_id": "query-123-abc",
      "metrics": {
        "domains": [
          {
            "domain_name": "IT",
            "external_id": "abdcde-domain",
            "skill_clusters": [
              {
                "external_id": "abdcde-cluster",
                "skill_cluster_name": "Software Engineering",
                "skills": [
                  {
                    "skill_id": "abcde-skill-1",
                    "skill_name": "Automated Testing",
                    "unique_employee_count": 10
                  }
                ],
                "sum_employee_skill_count": 10,
                "unique_employee_count": 10,
                "unique_skill_count": 1
              }
            ],
            "sum_employee_skill_count": 10,
            "unique_employee_count": 10,
            "unique_skill_count": 1
          }
        ],
        "skills_outside_taxonomy": {
          "skills": [
            {
              "skill_id": "abcde-skill-2",
              "skill_name": "Software Debugging",
              "unique_employee_count": 5
            }
          ],
          "sum_employee_skill_count": 5,
          "unique_employee_count": 5,
          "unique_skill_count": 1
        },
        "sum_employee_skill_count": 15,
        "unique_employee_count": 15,
        "unique_skill_count": 2,
        "total_employee_skill_count": 15
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

external_vendor

enum<string>

default:techwolf

The external vendor vocabulary you want to use for the returned metrics. This will only work for vendors that are activated on your tenant.

Available options:

techwolf,

workday,

sap_attribute_library

Example:

"workday"

vocab_language

enum<string>

default:en_uk

The display language used for Skill names. Altering the vocabulary language does not change the Skill Profile; it solely changes the way it is displayed. If not specified, the default language (en_uk) will be used. The en language is an alias for en_uk. IETF BCP 47 language tags (e.g. fr-FR, zh-CN) are also accepted and mapped to their internal equivalents.

Vendor-specific availability: Only the following languages are available for the default TechWolf vocabulary: en, en_uk, en_us, de, fr, nl. The additional languages (es, fr_ca, it, ja, ko, pt_br, zh_cn, zh_tw, sv, fi, da, no) are only available when the request is scoped to the workday vendor (via external_vendor=workday) and the tenant's Workday vocabulary includes them. Use GET /taxonomy/skills/languages to discover the exact set of languages available for a given vendor in your tenant.

Available options:

en,

en_uk,

en_us,

de,

fr,

nl,

es,

fr_ca,

it,

ja,

ko,

pt_br,

zh_cn,

zh_tw,

sv,

fi,

da,

no

Body

application/json

List of adoption metric queries. Each query corresponds with adoption metrics aggregated across the requested collection of objects.

queries

object[]

required

Show child attributes

Response

3-level Taxonomy
4-level Taxonomy
No Taxonomy

Response structure for Organisational Unit Metrics. Metrics are expressed in the structure of your Taxonomy. When a Skill is not represented in the Taxonomy, it will be included in the "Skills outside of the Taxonomy" Domain.

results

organisational_unit_metrics · object[]

required

A list of metrics related to each Organisational Unit.

Show child attributes

Get Employee count Get the employability metric using filters and weights

⌘I

API Documentation

API Versioning

AI Integration

Taxonomy

Employees

Job Families

Jobs

Peer Groups

Vacancies

Courses

Skill Clusters

External Companies

Skills

Tasks

Organisational Structure

Custom Properties

Matchmaking

Matching Configuration

Export

Reports

Version

Get Employee adoption metrics

Authorizations

Query Parameters

Body

Response