---
title: "Create New Document Sections"
method: POST
path: "/v1/document/{document_id}/sections"
tags: ["Document"]
---

# Create New Document Sections

`POST /v1/document/{document_id}/sections`

Create multiple new sections within a document

## Path parameters

- `document_id` string, uuid, required

## Request body

- CreateDocumentSections
  - `context` BaseRequestContext
    - `projectId` string, uuid
    - `processPublicId` string, uuid, nullable
    - `processSectionPublicId` string, uuid, nullable
    - `processResponsePublicId` string, uuid, nullable
  - `details` CreateDocumentSection[]
    - `context` BaseRequestContext
      - `projectId` string, uuid
      - `processPublicId` string, uuid, nullable
      - `processSectionPublicId` string, uuid, nullable
      - `processResponsePublicId` string, uuid, nullable
    - `name` string, required
    - `parentId` string, uuid, nullable
    - `description` union
      - Draftjs
        - `content` DraftjsContent, required
          - `blocks` DraftjsBlock[], required
            - `data` object, required
            - `depth` integer, required
            - `entityRanges` DraftjsEntityRange[], required
              - …
            - `inlineStyleRanges` DraftjsInlineStyleRange[], required
              - …
            - `key` string, required
            - `text` string, required
            - `type` string, required
          - `entityMap` object, required
      - object, nullable
    - `plaintextDescription` string, nullable

## Response `200`

Successfully created new document sections

- object
  - `metadata` object
  - `data` MortaDocumentSection[]
    - `publicId` string, uuid
    - `parentId` string, uuid
    - `position` integer
    - `description` Draftjs
      - `content` DraftjsContent, required
        - `blocks` DraftjsBlock[], required
          - `data` object, required
          - `depth` integer, required
          - `entityRanges` DraftjsEntityRange[], required
            - `offset` integer, required
            - `length` integer, required
            - `key` integer, required
          - `inlineStyleRanges` DraftjsInlineStyleRange[], required
            - `offset` integer, required
            - `length` integer, required
            - `style` string, required
          - `key` string, required
          - `text` string, required
          - `type` string, required
        - `entityMap` object, required
    - `name` string
    - `isDeleted` boolean
    - `deletedAt` string, date-time, nullable
    - `pdfIncludeDescription` boolean
    - `pdfIncludeSection` boolean
    - `pageBreakBefore` boolean
    - `children` MortaDocumentSection[]
    - `responses` DocumentResponse[]
      - `publicId` string, uuid
      - `position` integer
      - `response` unknown
      - `responseDate` string, date-time
      - `type` string
      - `typeOptions` unknown
      - `isDeleted` boolean
      - `deletedAt` string, date-time, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `user` SummaryUser
        - `firebaseUserId` string
        - `publicId` string, uuid
        - `name` string
        - `email` string
        - `profilePicture` string
      - `pdfIncludeResponse` boolean
      - `resetAfterResponse` boolean
      - `enableSubmission` boolean
    - `openCommentThreads` integer
    - `createdAt` string, date-time, nullable

## Other responses

- `404` — Document not found

---

[API](https://skmtc.net/morta-technology/apis/morta-api-reference.md) · [All operations](https://skmtc.net/morta-technology/apis/morta-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morta-technology/morta-api-reference/versions/9c58c1c1e7e8/schema)