# Footnotes operations

> Footnote and endnote lifecycle and numbering configuration.



6 operations. Names, descriptions, and behavior flags come from the canonical contract.

## Operations

- [`footnotes.list`](/document-api/reference/footnotes/list) (read): List all footnotes and endnotes in the document.
- [`footnotes.get`](/document-api/reference/footnotes/get) (read): Get detailed information about a specific footnote or endnote.
- [`footnotes.insert`](/document-api/reference/footnotes/insert) (mutates, tracked): Insert a new footnote or endnote at a target location or the current selection. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.
- [`footnotes.update`](/document-api/reference/footnotes/update) (mutates, tracked): Update the content of an existing footnote or endnote. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.
- [`footnotes.remove`](/document-api/reference/footnotes/remove) (mutates, tracked): Remove a footnote or endnote from the document.
- [`footnotes.configure`](/document-api/reference/footnotes/configure) (mutates): Configure numbering and placement for footnotes or endnotes.