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

# Create Section

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

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/saved/lists/{list_id}/sections`
- Auth: none declared

## 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

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

---

[API](https://skmtc.dev/stardrift/apis/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)