# Permission Ranges operations

> Permission range exception operations for protected documents.



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

## Operations

- [`permissionRanges.list`](/document-api/reference/permission-ranges/list) (read): List all permission ranges in the document. Returns only complete paired ranges (both start and end markers present).
- [`permissionRanges.get`](/document-api/reference/permission-ranges/get) (read): Get detailed information about a specific permission range by ID.
- [`permissionRanges.create`](/document-api/reference/permission-ranges/create) (mutates): Create a permission range exception region in the document. Inserts matched permStart/permEnd markers at the target.
- [`permissionRanges.remove`](/document-api/reference/permission-ranges/remove) (mutates): Remove a permission range by ID. Removes whichever markers exist for the given ID (start, end, or both).
- [`permissionRanges.updatePrincipal`](/document-api/reference/permission-ranges/update-principal) (mutates): Change which principal is allowed to edit a permission range. Updates the principal fields on the start marker.