# Captions operations

> Caption (SEQ field) inspection, insertion, update, removal, and numbering configuration.



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

## Operations

- [`captions.list`](/document-api/reference/captions/list) (read): List all caption paragraphs in the document.
- [`captions.get`](/document-api/reference/captions/get) (read): Get detailed information about a specific caption paragraph.
- [`captions.insert`](/document-api/reference/captions/insert) (mutates): Insert a new caption paragraph adjacent to a target block.
- [`captions.update`](/document-api/reference/captions/update) (mutates): Append patch text to an existing caption paragraph.
- [`captions.remove`](/document-api/reference/captions/remove) (mutates): Remove a caption paragraph from the document.
- [`captions.configure`](/document-api/reference/captions/configure) (mutates): Configure numbering format for a caption label.