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 Add Or Renew Employee Skill endpoint assigns a skill to an employee. If the employee already has this skill, the existing assignment is renewed instead of creating a duplicate: the previous values are kept as renewal history, and the assignment keeps the same employeeSkillKey. Include the details the skill tracks, such as issued and expiration dates, certification details, training details, and any documents to attach.
Renewals replace all fields. When renewing, send every value you want the assignment to keep. Any field you omit is cleared on the renewed assignment.
Use Cases
- A training platform records a certification on the employee's profile when they pass a course.
- A compliance tool renews a license with a new issued date and expiration date after the employee recertifies.
- Attach a certificate copy by including documentKeys from Create Employee Skill Document Uploads.
Company Set Behavior
Employee skills are stored per person (personId). The skill is assigned to the person behind this Employee ID, so it is visible on all of that person's Employee IDs within the company set.
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 Employee ID or skillKey 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.