---
title: "Add a Section to a Skill Plan"
method: POST
path: "/api/v2/skill-plans/{id}/sections"
tags: ["SkillPlan"]
---

# Add a Section to a Skill Plan

`POST /api/v2/skill-plans/{id}/sections`

This endpoint adds a new section to an existing skill plan. On a successful add, it returns a `201 Created` response. <br><br><h3>Required Scope</h3>`skill_plans:write`

## Path parameters

- `id` string, required

## Request body

- SkillPlanSectionBody
  - `data` PostedSkillPlansectionData
    - `type` string, nullable
    - `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`.

## Response `201`

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)