Skip to main content
POST
/
export
/
vacancies
/
skill_profiles
Export Vacancy Skill Profiles.
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/export/vacancies/skill_profiles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 10,
  "starting_after": "4cbdbabe-5644-4423-8157-520f8a2f429a",
  "filters": [
    {
      "filter": "is_active",
      "is_active": true
    }
  ]
}
'
{
  "has_next": true,
  "records": [
    {
      "external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
      "skills": [
        {
          "skill_name": "Git",
          "skill_id": "ed8a3b44-59a0-44a6-a283-6c0e4b303be1"
        },
        {
          "skill_name": "Jenkins",
          "skill_id": "eebcf485-9045-4669-a6f7-6e7faa465ff9"
        },
        {
          "skill_name": "Kubernetes",
          "skill_id": "94835c7e-4135-40d7-aea6-165b33d01589"
        }
      ]
    },
    {
      "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
      "skills": [
        {
          "skill_name": "Balance Sheet",
          "skill_id": "8313fe8a-f39e-4a35-8c82-93b46c3de9bb"
        },
        {
          "skill_name": "IFRS",
          "skill_id": "bdb5ee3f-8ba0-4c40-92b2-0277431ae069"
        }
      ]
    }
  ],
  "next_starting_after": "61a6e076-d780-11ec-9d64-0242ac120002"
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
response_format
enum<string>
default:list

The format of the response profile.

Available options:
list,
hierarchy
Example:

"list"

​
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.

Available options:
en,
en_uk,
en_us,
de,
fr,
nl
​
external_vendor
enum<string>

The external vendor vocabulary you want to see the Skills displayed in. This will only work for vendors that are activated on your tenant.

Available options:
workday,
sap_attribute_library
Example:

"workday"

Body

application/json
​
limit
integer
required

The number of Vacancy Skill Profiles to show on a single page.

Required range: 1 <= x <= 100
Example:

10

​
starting_after
string

The external_id of the Vacancy to continue looking from.

Maximum string length: 100
Example:

"4cbdbabe-5644-4423-8157-520f8a2f429a"

​
filters
(is_active · object | last_updated · object)[]

A set of filters used to apply on the exported Vacancy Skill Profiles.

  • is_active
  • last_updated

Response

OK

​
has_next
boolean
required

True when there is more data after this page.

Example:

true

​
records
(List · object | Hierarchy · object)[]
required

A list with for each entity the requested data, limited by limit.

The default Skill Profile result returned. The profile consists of a list of Skills with scores, with each score representing the importance of the Skill at hand.

  • List
  • Hierarchy
​
next_starting_after
string

The next starting_after value for pagination.

Maximum string length: 100
Example:

"61a6e076-d780-11ec-9d64-0242ac120002"