---
title: "Update a Skill"
method: PATCH
path: "/api/v2/skills-plus-skills{id}"
tags: ["Skills+"]
---

# Update a Skill

`PATCH /api/v2/skills-plus-skills{id}`

This endpoint updates a specific skill in Skills+. <h3>Required Scope</h3>`skill:write`

## Path parameters

- `id` string, required

## Request body

- V2SkillsplusskillsidBody
  - `data` Apiv2skillsplusskillsidData
    - `type` string
    - `id` string
    - `attributes` Apiv2skillsplusskillsidDataAttributes
      - `source-id` string — The ID of the skill source in Skills+.
      - `description` string — The description of the skill.
      - `external-id` string — The external ID of the skill.
      - `is-proprietary` boolean — Indicates whether the skill is proprietary to your organization.
      - `is-endorsed` boolean — Indicates whether this skill is endorsed. Endorsed Skills indicate that a learning professional in your organization reviewed and validated it.
      - `is-archived` boolean — Indicates whether the skill is archived.
      - `skill-review-access` string — Indicates if the skill is enabled for Skill Review and if the Skill Review-enabled skill is visible to everyone in the organization, or only visible to specific Groups. 'None' indicates Skill Review has not been enabled for this skill. 'Org' indicates the Skill Review-enabled skill is visible to everyone in the organization.
      - `skill-review-groups` string — The skill review group

## Response `200`

Success

- InlineResponse20032
  - `data` InlineResponse20032Data
    - `type` string
    - `id` string
    - `attributes` InlineResponse20032DataAttributes
      - `skill-name` string — The name of the skill.
      - `description` string — The description of the skill.
      - `external-id` string — The external ID of the skill.
      - `is-proprietary` boolean, nullable — Indicates whether the skill is proprietary to your organization.
      - `is-endorsed` boolean — Indicates whether this skill is endorsed. Endorsed Skills indicate that a learning professional in your organization reviewed and validated it.
      - `skill-review-visibility-groups` string[] — The list of groups who can view the skill in Skill Review.
      - `skill-review-visibility-access-level` string — Indicates if the skill is enabled for Skill Review and who can view it. For example, 'Org' for organization-wide visibility.
      - `locale` string, nullable — The locale associated with the skill, if applicable.
      - `synonyms` string[] — Alternative names or terms for the skill.
      - `skill-categories` string[] — Categories assigned to the skill.
      - `status` string — The status of the skill. For example, Draft or Active.
      - `skill-source-name` string — The name of the source the skill belongs to.
      - `skill-source-id` string — The ID of the source the skill belongs to.
      - `skill-source-description` string, nullable — A description of the skill source.
      - `is-archived` boolean — Indicates whether the skill is archived.
    - `links` InlineResponse20031DataLinks
      - `self` string, uri

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)