---
title: "Create Section"
method: POST
path: "/saved/lists/{list_id}/sections"
tags: ["saved"]
---

# Create Section

`POST /saved/lists/{list_id}/sections`

## Path parameters

- `list_id` string, uuid, required

## Headers

- `x-client-id` string, nullable

## Request body

- CreateSectionRequest
  - `title` string, required
  - `blurb` string, nullable
  - `item_ids` string[]

## Response `200`

Successful Response

- SavedSection — `item_ids` is both membership and display order; stale ids drop on read.
  - `id` string, required
  - `title` string, required
  - `blurb` string, nullable
  - `item_ids` string[]

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-16** `6d2ccd9ff8ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/saved/lists/:list_id/sections/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/2297d4453a9c?raw)