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

# Update a Specific Skill

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

This endpoint updates a specific skill for the current organization. <h3>Required Scope</h3>`skill:write`

## Path parameters

- `id` string, required

## Request body

- OrganizationskillsIdBody
  - `data` Apiv2organizationskillsidData
    - `type` string, nullable
    - `attributes` Apiv2organizationskillsidDataAttributes
      - `description` string — The description of the skill.
      - `external-id` string — The unique identifier of the skill.
      - `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-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. To limit the visibility to specific groups, use the POST endpoint to Add Skill Review Groups to a Skill (/organization-skills/[id]/relationships/skill-review-groups).

## Response `201`

Success

- InlineResponse2012
  - `data` InlineResponse2012Data
    - `type` string, nullable
    - `id` string, nullable — The unique skill id.
    - `attributes` InlineResponse2012DataAttributes
      - `name` string — The name of the skill.
      - `description` unknown
      - `external-id` string — The external ID of the skill.
      - `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-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. If the value is 'None', Skill Review has not been enabled for this skill. If the value is 'Org', the Skill Review-enabled skill is visible to everyone in the organization. 'Groups' indicates the Skill Review-enabled skill is only visible to specific Groups.
    - `relationships` InlineResponse2005DataAttributesRelationships[]
      - `groups-with-access` InlineResponse2005DataAttributesGroupswithaccess
        - `data` InlineResponse2005DataAttributesGroupswithaccessData[]
          - `id` string
          - `type` string
      - `associated-skills` InlineResponse2005DataAttributesAssociatedSkills
        - `data` InlineResponse2005DataAttributesAssociatedSkillsData[]
          - `id` string
          - `type` string

---

[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)