How to Create and Update Employee Skills

This guide will walk you through the steps to create or update employee skills using the relevant API endpoints in Skills and Safety.

Prerequisites

Before starting, ensure you have the following:

Access to Safety and Skills APIs.
API credentials (Client ID and Secret) for authentication.

Refer to the Getting Started with Request Tokens guide for details on how to authenticate.

Step 1: Retrieve Business Units

Purpose: Get the list of business units within your organization. The returned code is required for retrieving employees in the next step.

Response: The response will provide the code field, which is referenced as businessUnitCode needed for the next steps.

Step 2: Retrieve Employees in a Business Unit

Purpose: Use the business unit code (code) from Step 1 to retrieve employees within your business unit.

Response: The response will provide a list of employees. Use the code field from this response as a way to uniquely identify employees in future calls.

Step 3: Retrieve Available Skills

Purpose: Get the list of available skills that can be assigned to employees. You can either retrieve the existing skills or create new ones if needed.

Response: The response will include a list of skills available to be assigned.

note

If the skill you want doesn't exist, you can create a new skill using the Skills POST Endpoint.

Step 4: Assign or Update Skills for an Employee

Purpose: Once you have the employee code that references the employee you want and the skill name (either retrieved or created), you can now assign or update skills for the employee.

Response: The response will confirm the skill assignment or update for the selected employee.

note

You can archive/dismiss a skill if it is invalid or no longer in use. To do this, you can change the IsDismissed field in the EmployeeSkills POST endpoint.

Additional Notes

You can assign multiple skills to an employee by calling the endpoint for each skill.
Ensure the correct businessUnitId, employeeId, and skillId are provided to successfully assign or update the skills.

warning

Deleting a skill using the DELETE Endpoint under Skills will delete the targeted skill for ALL employees.

Troubleshooting

If you encounter any issues, refer to the Getting Started with Request Tokens guide or contact support for further assistance.