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.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).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.
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).
{
"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]
},
]
}
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
}
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 category ids are invalid, a validation failure response will be returned, containing the list of invalid category ids.
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.
Last modified 1yr ago