---
title: "Update a Specific Skill Plan"
method: PATCH
path: "/api/v2/skill-plans/{id}"
tags: ["SkillPlan"]
---

# Update a Specific Skill Plan

`PATCH /api/v2/skill-plans/{id}`

This endpoint updates supplied fields for a specific skill plan. <br><br>**Note:** The 'PATCH' endpoint does not support updating the 'sections' attribute of a Skill Plan with more than a 250 combined total of sections and resources. If the 'sections' attribute is included in the 'PATCH', the entire sections array will be replaced for the Skill Plan.<h3>Required Scope</h3>`skill_plans:write`

## Path parameters

- `id` string, required

## Request body

- PatchedSkillPlan
  - `data` PatchedSkillPlanData
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` PatchedSkillPlanDataAttributes
      - `name` string, nullable — Name of the plan.
      - `description` string, nullable — Description of the plan. This field supports markdown. For more information, see [Markdown Support](https://developer.degreed.com/reference/skillplan#markdown-support).
      - `external-id` string, nullable — The external identifier of the skill plan.
      - `subtitle` string, nullable — The subtitle of the skill plan.
      - `can-follow` boolean — Indicates whether other users can follow the skill plan.
      - `can-collaborate` boolean — Indicates whether one can collaborate on the plan.
      - `plan-type` string, nullable — Indicates the type of plan. Can only be `Target`, `Role`, or `Directory`. `Target` indicates that the record represents a `Skill Plan`. `Role` indicates that the record represents a `Role Plan`. `Directory` indicates that the record represents a `Directory`. `Browse` indicates that the record represents a `Featured Directory`.
      - `is-endorsed` boolean — Indicates whether the plan is endorsed. Endorsed Plans indicate that a learning professional in your organization reviewed and validated its content.
      - `image-url` string, nullable — Cover image of the skill plan.
      - `sections` SkillPlanSectionUpsert[], nullable
        - `title` string, nullable — The title of the section.
        - `section-type` string, string — The type of section. Section type must be one of the following values: `Provider`, `Content`, `Group`, `Opportunity`, `Pathway`, `Plan`, `People`, `Skill`, or `Text`.
        - `target-rating` integer — The target rating of the section when title is skill. **Note:** This should always be null. Please refer to `target-rating` on the resource level of section type `Skill`.
        - `sequence` integer — The sequence of the section.
        - `resources` SkillPlanResourceUpsert[], nullable
          - `id` string, nullable — The unique identifier of the resource.
          - `target-rating` integer, nullable — The target rating for the resource. This is only relevant if the section type is `Skill`.
          - `type` string, nullable — The type of resource.
          - `sequence` integer — The sequence of the resource.
          - `description` string — The description of the resource.
        - `display-mode` string, nullable — The way the section displays in the UI. Can only be `Compact` or `Expanded`.

## Response `200`

Success

- DetailedSkillPlan
  - `data` DetailedSkillPlanData
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` DetailedSkillPlanDataAttributes
      - `name` string, nullable — Name of the plan.
      - `description` string, nullable — Description of the plan.
      - `sections` SkillPlanSection[], nullable
        - `section-id` string
        - `sequence` integer — The sequence of the section.
        - `title` string, nullable — The title of the section.
        - `target-rating` integer — The target rating of the section when title is skill. **Note:** This should always be null. Please refer to `target-rating` on the resource level of section type `Skill`.
        - `resources` SkillPlanResource[], nullable
          - `section-resource-id` string — The resource’s id within the section.
          - `id` string, nullable — The unique identifier of the resource. When the section type is `skill`, id refers to the skill id of the skill labeled with title. The id can be used to look up the skill with the `/organization-skills` endpoint.
          - `sequence` integer — The sequence of the resource.
          - `type` string, nullable — The resource type. For example, `Skill`.
          - `title` string, nullable — The title of the resource.
          - `description` string, nullable — The description of the resource.
          - `target-rating` integer, nullable — The target rating for the skill. This is only relevant if the section type is `Skill`.
        - `description` string, nullable — Description of the section.
        - `section-type` string — The type of section. Section type must be one of the following values: `Provider`, `Content`, `Group`, `Opportunity`, `Pathway`, `Plan`, `People`, or `Skill`.
        - `display-mode` string, nullable — The way the section displays in the UI. Can only be `Compact` or `Expanded`.
      - `visibility` string, nullable — Can only be `Author`, `Public`, `Group`, `ProfileVisible`, `Template` or `Unknown`.
      - `can-collaborate` boolean — Indicates whether one can collaborate on the plan.
      - `degreed-url` string, nullable — URL location of the plan within Degreed UI.
      - `created-at` string, date-time — Date when the plan was created. (UTC)
      - `modified-at` string, date-time, nullable — Date when the plan was last modified. (UTC)
      - `plan-type` string, nullable — Indicates the type of plan. Can only be `Target`, `Role`, `Directory` or `Browse`. `Target` indicates that the record represents a `Skill Plan`. `Role` indicates that the record represents a `Role Plan`. `Directory` indicates that the record represents a `Directory`.
      - `is-endorsed` boolean — Indicates whether the plan is endorsed. Endorsed Plans indicate that a learning professional in your organization reviewed and validated its content.
      - `collaborators` SkillPlanCollaborator[], nullable
        - `type` string, nullable
        - `employee-id` string, nullable — Unique employee identifier of the collaborator.
        - `id` string, nullable — Unique identifier of the collaborator.
      - `external-id` string, nullable — The external identifier of the skill plan.
      - `subtitle` string, nullable — The subtitle of the skill plan.
      - `can-follow` boolean — Indicates whether other users can follow the skill plan.
      - `has-image` boolean — Indicates whether the plan has an image.
      - `image-url` string, nullable — Cover image of the skill plan.
    - `links` SelfLink
      - `self` string
    - `relationships` DetailedSkillPlanDataRelationships[], nullable
      - `collaborators` DetailedSkillPlanDataCollaborators
        - `data` DetailedSkillPlanDataCollaboratorsData[]
          - `id` string
          - `type` string
    - `sections` SkillPlanSection[], nullable
      - `section-id` string
      - `sequence` integer — The sequence of the section.
      - `title` string, nullable — The title of the section.
      - `target-rating` integer — The target rating of the section when title is skill. **Note:** This should always be null. Please refer to `target-rating` on the resource level of section type `Skill`.
      - `resources` SkillPlanResource[], nullable
        - `section-resource-id` string — The resource’s id within the section.
        - `id` string, nullable — The unique identifier of the resource. When the section type is `skill`, id refers to the skill id of the skill labeled with title. The id can be used to look up the skill with the `/organization-skills` endpoint.
        - `sequence` integer — The sequence of the resource.
        - `type` string, nullable — The resource type. For example, `Skill`.
        - `title` string, nullable — The title of the resource.
        - `description` string, nullable — The description of the resource.
        - `target-rating` integer, nullable — The target rating for the skill. This is only relevant if the section type is `Skill`.
      - `description` string, nullable — Description of the section.
      - `section-type` string — The type of section. Section type must be one of the following values: `Provider`, `Content`, `Group`, `Opportunity`, `Pathway`, `Plan`, `People`, or `Skill`.
      - `display-mode` string, nullable — The way the section displays in the UI. Can only be `Compact` or `Expanded`.
    - `included` DetailedSkillPlanDataIncluded[]
      - `id` string
      - `type` string
      - `attributes` DetailedSkillPlanDataAttributes1
        - `employee-id` string
      - `links` SelfLink
        - `self` 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/versions/4a22b709515c/schema)