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"
        }
      ]
    }
  ]
}'
{
  "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>

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:
workday
Example:

"workday"

Body

application/json

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

Response

OK

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.