boostrs api
Search…
Update Skills Batch
Use this API to update a list of custom skills or update the skill to category mapping. You can also link platform (Boostrs) skills to your skill categories.
Skill updates require at least one field to be specified in the request body.
The maximum size of the array of objects (skills) is 300 objects per request.

Body request sample

Request for updating custom (client-owned) skills

This example depicts the case in which the following actions will take place, as requested:
  • skill attributes are updated: name, external_id, description
  • skills are added (linked) to new categories (ex: skill 12345 is also linked to category 7678)
1
{
2
"skills": [
3
{
4
"id": 12345,
5
"name": "name value here",
6
"external_id": "ASDG-1212",
7
"category_id": 7678
8
},
9
{
10
"id": 12346,
11
"name": "name value here",
12
"external_id": "ASDG-1234",
13
"category_id": 4457
14
}
15
]
16
}
Copied!

Request for mapping Boostrs skills to a category

The Boostrs skills (also referred to as "platform skills") can be mapped (linked to) a custom skill category.
Boostrs skill attributes cannot be modified (ex: title, description, external_id).
1
{
2
"skills": [
3
{
4
"id": 13497,
5
"category_id": 3379
6
},
7
{
8
"id": 13502,
9
"category_id": 3379
10
}
11
]
12
}
Copied!

Validations & error messages

Invalid category_id

If any of the provided categories are invalid, a validation failure response will be returned, containing the list of invalid category ids.
Each category must be a bottom level category (cannot contain any sub-categories).

Update forbidden for platform skills

If any of the provided platform skills contains other fields, a validation failure response will be returned, containing the list of platform skills for which extra fields were provided.
Platform skills can only be mapped (referenced) to a custom skills category, but the attributes of the platform skills cannot be changed.
The request for mapping a platform skill must only contain the skill_id and the category_id to which the skill will be mapped. Using additional fields will lead to a validation error. See Request for mapping Boostrs skills to a category request sample.

Invalid skill_id

If any of the provided skills are invalid, a validation failure response will be returned, containing the list of invalid skill ids.

Duplicate skill_id

If any of the provided skills have duplicate skill_id, a validation failure response will be returned, containing the list of duplicate skill ids.

Duplicate skill name

The skills must be unique by name within each category either when updating skill names or when moving them to another category.
If any of the provided skill names are already present in the category specified for mapping, a validation failure response will be returned, containing each category and the skills already existing for it.