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 Create Skill endpoint adds a new skill, certification, or license to the company's skill catalog. You define the skill's code and name, whether it expires, how far ahead renewal is flagged, and which extra details (proficiency, certification, training, documents) are tracked when it is assigned to employees. The skill code must be unique among active skills.
Use Cases
- A training platform adds a new certification to the client's catalog when the client launches a new course.
- A compliance tool creates license types (for example, Registered Nurse License) with a 2-year expiration and a 60-day renewal window.
- Set up a client's full skill catalog during onboarding.
Company Set Behavior
A skill created using one Company ID is visible to every Company ID in the company set. You cannot create a skill for only one Company ID.
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 was not found.
429Too Many Requests. The API client exceeded the rate limit of 3 requests per second. Wait briefly, then retry using a backoff strategy.