> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-nick-sd-2099-images-core-lifecycle-placement-seman.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     |