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

# Update a Section in a Skill Plan

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

This endpoint updates the specified section in an existing skill plan. On a successful update, it returns a `200 OK` response. <br><br><h3>Required Scope</h3>`skill_plans:write`

## Path parameters

- `id` string, required
- `section-id` string, required

## Request body

- SkillPlanSectionPatchBody
  - `data` PostedSkillPlansectionpatchData
    - `id` string
    - `type` string, nullable
    - `attributes` PostedSkillPlansectionspatchAttributes
      - `sequence` integer — The sequence of the section. By default, sequence will append to end of current sequence. If the sequence has already been used with another section, an error will occur.
      - `title` string
      - `description` string, nullable — Description of the section. This field supports markdown. For more information, see [Markdown Support](https://developer.degreed.com/reference/skillplan#markdown-support).
      - `display-mode` string, nullable — The way the section displays in the UI. Can only be `Compact` or `Expanded`.

## Response `200`

Success

- SkillPlanSectionPosted
  - `data` PostedSkillPlansectionpostedData
    - `type` string, nullable
    - `id` string — Unique id of the section.
    - `attributes` PostedSkillPlansectionsAttributes
      - `sequence` integer — The sequence of the section. By default, sequence will append to end of current sequence. If the sequence has already been used with another section, an error will occur.
      - `title` string
      - `description` string, nullable — Description of the section. This field supports markdown. For more information, see [Markdown Support](https://developer.degreed.com/reference/skillplan#markdown-support).
      - `section-type` string, required — The type of section. Section type must be one of the following values: `Provider`, `Content`, `Group`, `Opportunity`, `Pathway`, `Plan`, `People`, `Skill`, or `Text`.
      - `display-mode` string, nullable — The way the section displays in the UI. Can only be `Compact` or `Expanded`.

---

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