Early Access (EA)This API is currently in Early Access and available only to approved EA participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.
Summary Description
The Request Skill Removal endpoint removes one or more skills from the company's skill catalog. Only skills that are not assigned to any employee can be removed. The request returns 201 Created with no response body.
Use Cases
- Clean up skills that are no longer used, such as a retired certification.
- Remove skills created in error during setup.
Company Set Behavior
Because skills are shared across the company set, removing a skill removes it for every Company ID in the set. A skill that is still assigned to any employee in the company set cannot be removed: the request returns 400 Bad Request for that skill. Delete the employee assignments first, or set active to false with Update Skill (Partial) to stop new assignments without removing history.
201Created. The removal request was accepted. No response body is returned.
401Unauthorized. The bearer token is missing, invalid, or expired. Request a new access token and try again.
403Forbidden. The token is valid, but the API client is not authorized to access this API or this company.
404Not Found. The Company ID does not exist or is not accessible to the API client.
429Too Many Requests. The API client exceeded the rate limit of 3 requests per second. Wait briefly, then retry using a backoff strategy.