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

Import Skills Batch

Delete Skills Batch

Last modified 1mo ago

Copy link

Contents

patch

Update skill details and map (link) skills to skill categories as needed

Body request sample

Request for updating custom (client-owned) skills

Request for mapping Boostrs skills to a category

Validations & error messages

Invalid category_id

Update forbidden for platform skills

Invalid skill_id

Duplicate skill_id

Duplicate skill name