boostrs api
Search
⌃K

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.
The maximum size of the array of objects (skills) is 300 objects per request.
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.
{
"skills": [
{
"id": 12345,
},
{
"id": 23456,
}
]
}
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).
{
"skills": [
{
"id": 12345,
"category_id": [3138, 3232]
},
{
"id": 23456,
"categories": [3140]
},
]
}

Delete permanently skills from category

When using the delete_permanently parameter, the request body must include only the skill_id array of objects.
{
"skills": [
{
"id": 12345,
},
{
"id": 23456
}
],
delete_permanently: 1
}

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.