# Hyperlinks operations

> Hyperlink discovery, creation, and metadata management.



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

## Operations

- [`hyperlinks.list`](/document-api/reference/hyperlinks/list) (read): List all hyperlinks in the document, with optional filtering by href, anchor, or display text.
- [`hyperlinks.get`](/document-api/reference/hyperlinks/get) (read): Retrieve details of a specific hyperlink by its inline address.
- [`hyperlinks.wrap`](/document-api/reference/hyperlinks/wrap) (mutates): Wrap an existing text range with a hyperlink.
- [`hyperlinks.insert`](/document-api/reference/hyperlinks/insert) (mutates, tracked): Insert new linked text at a target position.
- [`hyperlinks.patch`](/document-api/reference/hyperlinks/patch) (mutates): Update hyperlink metadata (destination, tooltip, target, rel) without changing display text.
- [`hyperlinks.remove`](/document-api/reference/hyperlinks/remove) (mutates): Remove a hyperlink. Mode 'unwrap' preserves display text; 'deleteText' removes the linked content entirely.