> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# Working with Sections

> **Info**
>
> ### Beta APIs
>
> The Document APIs are beta. Send the `EARLY-ACCESS: true` header on every request shown here; without it these endpoints are unavailable. See [Introduction to Documents](/docs/introduction-to-documents) and the [Stability Guidelines](/docs/stability-guidelines).

Sections divide a document into logical groups and appear in the document content list like every other piece of content. They have a few important properties.

* All document types support sections except entry subtemplates.
* All entries and entry templates must start with a section.
* Sections must include either a date or a title.
* Sections that include dates must be in chronological order. You can place sections without a date anywhere in the document.
* Sections are never empty. If a `partsMutation` creates an empty section, the API inserts an empty text document part after it.

## Section children

In Benchling, collapsing a section hides all document content that follows it. The API represents document content as a flat list, so understand the implicit relationship between a section and the content that follows it.

This also means that a `partsMutation` such as `move` or `delete` automatically changes which document content each section collapses.

The example below shows this. Here, the Results section would collapse all content before the Conclusion section.

![A Benchling entry showing a collapsed Results section above an expanded Conclusion section](/_fern-files/_img/334c5241fd0d35b88c008da1e61e3188719ac5f2f4c5bd0bcc7f775be1c4486f.webp)

**`Endpoint`**

```text title="Endpoint"
GET /api/v3/entry/etr_2uBIDQGZ9W/parts/items
```

**`Example Response`**

```json title="Example Response"
{
  "items": [
    {
      "__typename": "DocumentPartSection",
      "id": "docpart_Qm3nW8x1",
      "modifiedAt": "2025-01-15T10:30:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "title": "Results",
      "date": "2025-01-15",
      "color": null
    },
    {
      "__typename": "DocumentPartHeader",
      "id": "docpart_Kp9vR2y4",
      "modifiedAt": "2025-01-15T14:22:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "headerType": "HEADER_1",
      "text": "Experiment Results",
      "formats": [],
      "links": [],
      "mentions": [],
      "indentation": 0
    },
    {
      "__typename": "DocumentPartText",
      "id": "docpart_Xt5bJ7z3",
      "modifiedAt": "2025-01-15T14:22:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "text": "The following data was collected on 2025-01-15.",
      "formats": [],
      "links": [],
      "mentions": [],
      "indentation": 0
    },
    {
      "__typename": "DocumentPartUnstructuredTable",
      "id": "docpart_Nw4mP1a8",
      "modifiedAt": "2025-01-15T14:22:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "name": "Concentration Measurements",
      "caption": null,
      "columnDefinitions": [
        { "name": "Sample" },
        { "name": "Concentration (mg/mL)" }
      ],
      "rowCount": 3,
      "rows": "https://benchling.com/api/v3/document-part-unstructured-table/docpart_Nw4mP1a8/rows/items",
      "isEvaluated": false,
      "indentation": 0
    },
    {
      "__typename": "DocumentPartAttachment",
      "id": "docpart_Fg7hL2m9",
      "modifiedAt": "2025-01-15T15:00:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "externalFileId": "efl_RkQ2Xp7m",
      "filename": "western_blot_day3.tif",
      "download": {
        "url": "https://s3.amazonaws.com/benchling-attachments/...?X-Amz-Expires=3600&...",
        "expiresAt": "2025-01-15T16:00:00Z"
      },
      "scanStatus": "NO_THREATS_FOUND",
      "size": 2097152,
      "caption": null,
      "customWidth": null,
      "indentation": 0
    },
    {
      "__typename": "DocumentPartSection",
      "id": "docpart_Gq4zK9y5",
      "modifiedAt": "2025-01-15T10:30:00Z",
      "versionMetadata": { "versionId": "etrver_Ax7b2kR9", "createdAt": "2025-01-15T15:00:00Z" },
      "title": "Conclusion",
      "date": "2025-01-16",
      "color": null
    }
  ],
  "nextToken": ""
}
```