Skills

Use this API to retrieve skills details.

Quick Start: Add a Skill to an Employee

Use this guide to first find the skill ID you need, and then add that skill to an employee’s profile.

To add a skill to an employee, you’ll complete two steps:

Get the skill ID

Update the employee’s skills

Step1:
Get the Skill ID
Before you can add a skill to an employee, you need to locate the skill’s internal ID.

Use the Get Skills endpoint to search for the skill you want.


galaxyskills:read

You can narrow the results using query parameters such as:


SearchText — searches by skill name
CapabilityStatuses — defaults to Active if not provided
CapabilityTypes — use Skill to return skills only
CategoryIds — filters by skill category
Ids — returns specific capability IDs if you already know them

If successful, the response will include a list of matching skills.


Example response excerpt:

{
	"correlationId": "f3b7a2f1-1d4e-4e4c-9d7b-3d1d8f1a1234",
	"data": {
		"item1": [
			{
				"id": "12345",
				"name": "Communication",
				"localizedNames": {
					"en-US": "Communication"
				},
				"type": "Skill",
				"status": "Active"
			}
		],
		"item2": {
			"currentPage": 1,
			"pageSize": 50,
			"totalCount": 1,
			"totalPages": 1
		}
	},
	"status": "Success",
	"timestamp": "2026-06-05T12:00:00Z"
}

From this response, copy the skill’s id.
In this example, the skill ID is 12345.

Step2:
Update the Employee’s Skills
Now that you have the skill ID, you can add it to the employee profile using the Update Employee Skills endpoint.

galaxyemployeeskills:update

Replace {employeeId} with the employee’s ID.


Example Request
To add the skill Communication to employee 9025, send the skill ID in skillsAddedto the user’s path: /v1/employees/9025/skills

{
	"skillsAdded": [
		{
			"skillId": "12345",
			"source": "Cornerstone Application"
		}
	],
	"type": "Proficiency"
}

Request Field Notes- skillsAdded — skills to add to the employee profile
skillId — internal skill identifier from the Get Skills response
source — source system name, such as Cornerstone Application
type — employee skill classification, such as Proficiency or Interest

Optional: Add More Than One Skill
You can add multiple skills in the same request by including more than one object in skillsAdded.

{
	"skillsAdded": [
		{
			"skillId": "12345",
			"source": "Cornerstone Application"
		},
		{
			"skillId": "67890",
			"source": "Cornerstone Application"
		}
	],
	"type": "Interest"
}

Optional: Remove a Skill
If needed, you can also remove a skill using skillsDeleted.

{
	"skillsDeleted": [
		{
			"skillId": "12345",
			"source": "Cornerstone Application"
		}
	],
	"type": "Proficiency"
}

Get Employee Skills

Use this endpoint to fetch the skill records linked to an employee by their employee ID. The API returns the employee’s skills data, along with pagination details for the result set.

To use this service, you need to provide the Employee ID in the path. The endpoint returns the skills associated with that employee only.

  • Employee ID is required.
  • The response includes the skill data for the specified employee.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyemployeeskills:read

Update Employee Skills

Use this endpoint to update the skills associated with an employee.

To use this service, you need to provide the Employee ID in the path. The API updates the employee’s skill records based on the request body.

  • Employee ID is required.
  • skillsAdded can be used to add one or more skills to the employee profile.
  • skillsDeleted can be used to remove one or more skills from the employee profile.
  • type identifies the employee skill classification, such as Proficiency or Interest.
  • The response returns the update result, along with pagination details when applicable.

OAuth2.0 Scope: galaxyemployeeskills:update

Get Skill Categories

Use this endpoint to retrieve skill categories.

To use this service, you can filter the results by category IDs, parent category IDs, search text, or status. The API returns a collection of skill categories and pagination details for the result set.

  • Ids is optional and filters categories by specific category IDs.
  • SearchText is optional and searches within category names.
  • ParentIds is optional and returns child categories under the specified parent category IDs.
  • Statuses is optional and filters by category status, such as Active or Inactive.
  • The response includes the category collection for the matching results.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskillcategories:read

Create Skill Category

Use this endpoint to create a new skill category.

To use this service, provide the category details in the request body. The API creates a new skill category and returns the created record.

  • localizedNames is required and must include localized category names.
  • externalId is optional and can be used to map the category to a source system.
  • parentCategoryId is optional and can be used to create hierarchical categories.
  • source is optional and defaults to Cornerstone Application if not provided.
  • The response includes the newly created skill category details.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskillcategories:create

Get Skill Category By ID

Use this endpoint to retrieve a skill category by its ID.

To use this service, you need to provide the category ID in the path. The API returns the matching skill category record.

  • ID is required.
  • The response includes the skill category details for the specified ID.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskillcategories:read

Update Skill Category

Use this endpoint to update an existing skill category.

To use this service, you need to provide the category ID in the path. The API updates the matching category record based on the request body.

  • ID is required.
  • localizedNames is optional and updates the category’s localized names.
  • parentCategoryId is optional and updates the parent category relationship.
  • status is optional and can be set to Active, Inactive, or Draft.
  • The response returns the updated category details.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskillcategories:update

Get Skill Category Children

Use this endpoint to retrieve child categories of a skill category.

To use this service, you need to provide the category ID in the path. The API returns the child categories associated with that category.

  • ID is required.
  • The response includes the child category collection for the specified category.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskillcategories:read

Get Skills

Use this endpoint to retrieve skills.

To use this service, you can filter and sort the skill list using query parameters. The API returns skill records and pagination details for the result set.

  • Page is optional and specifies the page number.
  • PageSize is optional and controls the number of items returned per page.
  • Ids is optional and filters by specific capability IDs.
  • CapabilitySortOption is optional and controls the sort order.
  • Direction is optional and sets ascending or descending sort direction.
  • ExternalIds, Sources, SearchText, CapabilityTypes, CapabilityStatuses, and CategoryIds are optional filters.
  • IncludeChildCategories is optional and includes child categories in category filtering.
  • IncludeSkillsGraphAttributes is optional and includes skill graph attributes in the response.
  • The response includes the matching skill collection.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskills:read

Create Skill

Use this endpoint to create a new skill.

To use this service, provide the skill details in the request body.
If externalId and source match an existing skill, the API updates the existing skill instead of creating a duplicate.

  • localizedNames is required for new skills.
  • localizedDescriptions is optional and provides localized skill descriptions.
  • categoryIds is optional and associates the skill with one or more categories.
  • description is deprecated and should be replaced by localizedDescriptions.
  • name is deprecated and should be replaced by localizedNames.
  • externalId and source can be used for upsert behavior.
  • status is optional and defaults to Active if not provided.
  • The response includes the created skill record.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskills:create

Get Skill By ID

Use this endpoint to retrieve a skill by its ID.

To use this service, you need to provide the skill ID in the path. The API returns the matching skill record.

  • ID is required.
  • The response includes the skill details for the specified ID.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskills:read

Update Skill

Use this endpoint to update an existing skill.

To use this service, you need to provide the skill ID in the path. The API updates the matching skill record based on the request body.

  • ID is required.
  • categoryIds is optional and updates the categories associated with the skill.
  • description is deprecated and should be replaced by localizedDescriptions.
  • localizedNames is optional and updates the localized skill names.
  • localizedDescriptions is optional and updates the localized skill descriptions.
  • name is deprecated and should be replaced by localizedNames.
  • status is optional and can be set to Active, Inactive, or Draft.
  • The response returns the updated skill record.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskills:update

Get Skill Categories By Skill

Use this endpoint to retrieve categories associated with a skill.

To use this service, you need to provide the skill ID in the path. The API returns the categories linked to that skill.

  • ID is required.
  • The response includes the category list associated with the specified skill.
  • Pagination metadata is included in the response when applicable.

OAuth2.0 Scope: galaxyskills:read