permissionRanges.list

List all permission ranges in the document. Returns only complete paired ranges (both start and end markers present).

Summary

List all permission ranges in the document. Returns only complete paired ranges (both start and end markers present).

• Operation ID: permissionRanges.list
• API member path: editor.doc.permissionRanges.list(...)
• Mutates document: no
• Idempotency: idempotent
• Supports tracked mode: no
• Supports dry run: no
• Deterministic target resolution: yes

Expected result

Returns a PermissionRangesListResult containing discovered permission ranges with principal and position data.

Input fields

Field	Type	Required	Description
limit	integer	no
offset	integer	no

Example request

{
  "limit": 50,
  "offset": 0
}

Output fields

No fields.

Example response

{}

Pre-apply throws

• TARGET_NOT_FOUND
• CAPABILITY_UNAVAILABLE

Non-applied failure codes

• None

Raw schemas

Raw input schema

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

Raw output schema

{
  "type": "object"
}