---
title: "Create Section"
method: POST
path: "/v1/projects/{project_id}/context/sections"
tags: ["project-context"]
---

# Create Section

`POST /v1/projects/{project_id}/context/sections`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/context/sections`
- Auth: none declared

Add a context section (ContextWriter — context:write). Records the section's v1 history and
recomputes the derived context_document mirror.

## Path parameters

- `project_id` string, required

## Request body

- SectionIn
  - `title` string, required
  - `type` string: overview|writing|qa|constraints|terminology|other (open-set).
  - `languages` string[]: target codes this section applies to; empty = all.
  - `body` string
  - `position` integer, nullable

## Response `201`

Successful Response

- SectionOut
  - `uuid` string, required
  - `title` string, required
  - `type` string, required
  - `languages` string[], required
  - `position` integer, required
  - `updated_at` string, date-time, nullable
  - `body` string, required

## Other responses

- `422`: Validation Error

---

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