Delete Skills Batch

The purpose of this API is to remove the mapping (link) to categories for a given skill list or to delete the skills list while also removing their mapping (unlink) to categories.

delete
https://apigateway.boost.rs
/skills/batch
Delete custom skills or remove (unlink) platform skills from your skills category
The maximum size of the array of objects (skills) is 300 objects per request.
Remove (unlink) skill mapping from all categories
You may specify one or more skill_id objects for the skills you want to remove (unlink) from all your categories.
This action will only delete the reference of the skill_id to all its parent category_id objects (unlink the skill from categories).
What happens to the platform (Boostrs) skills?
If a platform skill is no longer linked to any of your skill categories, it is no longer linked to your skill set in any way. You can use the Skills Batch Update API and connect it to one or more of your skill categories anytime later, as need.
What happens to my own skills (custom, imported skills)?
Custom skills (skills imported by you) will not be deleted from your skill set. They're accessible through the Skill List and Skill Details APIs, only they're orphaned (don't belong to any categories). 
You can use the Skills Batch Update API to link any of your skills to your categories as needed. 
1
{
2
    "skills": [
3
        {
4
            "id": 12345,
5
        },
6
        {
7
            "id": 23456,
8
        }
9
    ]
10
}
Copied!
Remove (unlink) skills from specific categories
You may specify one or more skill_id objects for the skills you want to remove (unlink) from the specified categories.
This action will only remove the reference of the skill_id to all its parent category_id objects (unlink the skill from categories).
1
{
2
    "skills": [
3
        {
4
            "id": 12345,
5
            "category_id": [3138, 3232]
6
        },
7
        {
8
            "id": 23456,
9
            "categories": [3140]
10
        },
11
    ]
12
}
Copied!
Delete permanently skills from category
When using the delete_permanently parameter, the request body must include only the skill_id array of objects.
1
{
2
    "skills": [
3
        {
4
            "id": 12345,
5
        },
6
        {
7
            "id": 23456
8
        }
9
    ],
10
    delete_permanently: 1
11
}
Copied!
Validations & error messages
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.
Invalid category_id
If any of the provided category ids are invalid, a validation failure response will be returned, containing the list of invalid category ids.
Delete permanently - too many parameters
When requesting a permanent deletion of skills, the request body must only include the skill_id array of objects. No other fields (ex: category_id) are allowed, as the operation automatically removes the mapping of the skill from all the categories it was linked to.
If the delete_permanently parameter is provided and category_id is included in the request body (for one or more skills), a validation failure response will be returned.
The reason for this validation error is to prevent the case when a previous permanent deletion was performed and due to some error a new request is being sent with the intent of a mapping update and the parameter was not removed. This way an erroneous permanent skill deletion can be avoided.

Update Skills Batch

Next - Mapping APIs

Extract Skills

Last modified 1mo ago

Copy link

Contents

delete

Delete custom skills or remove (unlink) platform skills from your skills category

Remove (unlink) skill mapping from all categories

Remove (unlink) skills from specific categories

Delete permanently skills from category

Validations & error messages

Invalid skill_id

Invalid category_id

Delete permanently - too many parameters