> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-nick-sd-2070-add-content-controls-namespace-to-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists operations

> Lists operation reference from the canonical Document API contract.

> Alpha: Document API is currently alpha and subject to breaking changes.

[Back to full reference](../index)

List inspection and list mutations.

| Operation                                                                                                                                                                                                        | Member path                       | Mutates | Idempotency      | Tracked | Dry run |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ------- | ---------------- | ------- | ------- |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/list"><code>lists.list</code></a></span>                                              | `lists.list`                      | No      | `idempotent`     | No      | No      |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/get"><code>lists.get</code></a></span>                                                | `lists.get`                       | No      | `idempotent`     | No      | No      |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/insert"><code>lists.insert</code></a></span>                                          | `lists.insert`                    | Yes     | `non-idempotent` | Yes     | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/create"><code>lists.create</code></a></span>                                          | `lists.create`                    | Yes     | `non-idempotent` | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/attach"><code>lists.attach</code></a></span>                                          | `lists.attach`                    | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/detach"><code>lists.detach</code></a></span>                                          | `lists.detach`                    | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/indent"><code>lists.indent</code></a></span>                                          | `lists.indent`                    | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/outdent"><code>lists.outdent</code></a></span>                                        | `lists.outdent`                   | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/join"><code>lists.join</code></a></span>                                              | `lists.join`                      | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/can-join"><code>lists.canJoin</code></a></span>                                       | `lists.canJoin`                   | No      | `idempotent`     | No      | No      |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/separate"><code>lists.separate</code></a></span>                                      | `lists.separate`                  | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level"><code>lists.setLevel</code></a></span>                                     | `lists.setLevel`                  | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-value"><code>lists.setValue</code></a></span>                                     | `lists.setValue`                  | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/continue-previous"><code>lists.continuePrevious</code></a></span>                     | `lists.continuePrevious`          | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/can-continue-previous"><code>lists.canContinuePrevious</code></a></span>              | `lists.canContinuePrevious`       | No      | `idempotent`     | No      | No      |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-restart"><code>lists.setLevelRestart</code></a></span>                      | `lists.setLevelRestart`           | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/convert-to-text"><code>lists.convertToText</code></a></span>                          | `lists.convertToText`             | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/apply-template"><code>lists.applyTemplate</code></a></span>                           | `lists.applyTemplate`             | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/apply-preset"><code>lists.applyPreset</code></a></span>                               | `lists.applyPreset`               | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-type"><code>lists.setType</code></a></span>                                       | `lists.setType`                   | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/capture-template"><code>lists.captureTemplate</code></a></span>                       | `lists.captureTemplate`           | No      | `idempotent`     | No      | No      |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-numbering"><code>lists.setLevelNumbering</code></a></span>                  | `lists.setLevelNumbering`         | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-bullet"><code>lists.setLevelBullet</code></a></span>                        | `lists.setLevelBullet`            | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-picture-bullet"><code>lists.setLevelPictureBullet</code></a></span>         | `lists.setLevelPictureBullet`     | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-alignment"><code>lists.setLevelAlignment</code></a></span>                  | `lists.setLevelAlignment`         | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-indents"><code>lists.setLevelIndents</code></a></span>                      | `lists.setLevelIndents`           | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-trailing-character"><code>lists.setLevelTrailingCharacter</code></a></span> | `lists.setLevelTrailingCharacter` | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level-marker-font"><code>lists.setLevelMarkerFont</code></a></span>               | `lists.setLevelMarkerFont`        | Yes     | `conditional`    | No      | Yes     |
| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/clear-level-overrides"><code>lists.clearLevelOverrides</code></a></span>              | `lists.clearLevelOverrides`       | Yes     | `conditional`    | No      | Yes     |