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.
patch
https://apigateway.boost.rs
/skills/batch
Update skill details and map (link) skills to skill categories as needed
The maximum size of the array of objects (skills) is
300
objects per request.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 category7678
)
{
"skills": [
{
"id": 12345,
"name": "name value here",
"external_id": "ASDG-1212",
"category_id": 7678
},
{
"id": 12346,
"name": "name value here",
"external_id": "ASDG-1234",
"category_id": 4457
}
]
}
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).
{
"skills": [
{
"id": 13497,
"category_id": 3379
},
{
"id": 13502,
"category_id": 3379
}
]
}
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).
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.If any of the provided skills are invalid, a validation failure response will be returned, containing the list of invalid skill ids.
If any of the provided skills have duplicate
skill_id
, a validation failure response will be returned, containing the list of duplicate skill ids.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.
Last modified 1yr ago