> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

# Employee Skill Sync Integration with Degreed

This Deployment Guide provides instructions that will assist in the process of
deploying the Degreed - TechWolf Employee Skill Sync Integration, including
detail on the configuration and deployment of the integration in the customer's
Degreed tenant. The intended audience for this document is the Integration
Implementer.

## Integration

The Integration has been designed, developed, tested, documented, and deployed
by TechWolf with Degreed's guidance and oversight. The integration facilitates
the flow of validated employee skill data between Degreed and TechWolf. It is
not intended to address every use case a customer may be interested in. The
customer benefits by receiving pre-built, pre-tested, documented,
partner-maintained integrations that minimize implementer's effort as compared
to custom integrations for the specific use case(s) addressed.

## Functional Objective

TechWolf and Degreed are partnering to enhance skill management within
organizations. TechWolf leverages data from various sources, including business
systems, to infer Skills. These inferred Skills are seamlessly integrated into
Degreed Skill Profiles, providing a comprehensive and real-time view of
Employees' Skills. The integration also enables profile synchronization between
TechWolf and Degreed, ensuring that both platforms' updates are consistently
reflected.

This can be further facilitated with the use of the
[TechWolf Skill Assistant <Icon icon="link" iconType="solid" />](/integrations/skill-assistant/overview),
where employees can either be notified of or validate newly suggested skills.
This integration does not depend on the Skill Assistant; any other skill
validation approach can be used. The integration is agnostic to the skill
validation.

**Key benefits:**

* TechWolf synchronizes Employee Skill Profiles across all relevant systems,
  harmonizing Skills across all systems
* The accurate and up-to-date skill data in Degreed can be used for downstream
  purposes in the system, e.g. Learning Paths and Skill Development
* As TechWolf does not rely on manual assessments, we increase Employee adoption
  to your learning platform with automated skill profiles

## Reference Material

Reference materials and documentation can be found at:

* TechWolf developer documentation:
  [https://developers.techwolf.ai/ <Icon icon="link" iconType="solid" />](https://developers.techwolf.ai/)
* TechWolf Skill Sync source IP addresses:
  [IP Addresses <Icon icon="link" iconType="solid" />](/integrations/reference/ip-addresses)
* Degreed API documentation:
  [https://developer.degreed.com/ <Icon icon="link" iconType="solid" />](https://developer.degreed.com/)
* Used Degreed Web Service operations:
  * `GET /api/v2/users/:user-id/user-skills`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/get_api-v2-users-id-user-skills))
  * `POST /api/v2/user-skills`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/post_api-v2-user-skills))
  * `DELETE /api/v2/user-skills/:user-skill-id`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/delete_api-v2-user-skills-userskillid))
  * `GET /api/v2/users/:user-id/skill-ratings`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/get_api-v2-users-id-skill-ratings))
  * `POST /api/v2/skill-ratings`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/post_api-v2-skill-ratings))
  * `DELETE /api/v2/skill-ratings/:user-skill-rating-id`
    ([Degreed API <Icon icon="link" iconType="solid" />](https://developer.degreed.com/reference/delete_api-v2-skill-ratings-userskillratingid))

## Glossary of Terms

* **API Key**: A unique identifier used to authenticate API requests to Degreed.
  Contains both a client ID and client secret for secure access.

* **Scopes**: Specific permissions that define what data and operations the API
  key can access. Required scopes for this integration are limited to:
  * `user_skills:read` - Read access to user skill data
  * `user_skills:write` - Write access to user skill data
  * `skill_ratings:read` - Read access to skill rating data
  * `skill_ratings:write` - Write access to skill rating data

* **Client ID**: A public identifier for the API key that can be safely shared.

* **Client Secret**: A private credential that must be kept secure and is only
  shown once during API key creation.

* **Skills Library**: Degreed's centralized repository of skills available
  across the platform.

* **User Skills**: Individual skill assignments to users in Degreed.

* **Skill Ratings**: Proficiency levels assigned to user skills (1-N scale,
  where N is an integer corresponding to the customer's Degreed setup).

* **Proficiency Scale**: Numerical range representing skill competency levels.

* **Bidirectional Sync**: Two-way synchronization between systems.

* **Uni-directional Sync**: One-way synchronization from source to target
  system.
