> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Inspect Page sharing

> Inspect the current audience, sharing revision, recipients and Editor-assignment capability. Recipient listing accepts cursor and limit (1–100). Only the Author or an independently admitted current Workspace admin can inspect sharing. Uses a validated person-attributed account key through Forward or the MCP metered path. Returns trace_id on every operation result. Guest email proof grants no management authority.



## OpenAPI

````yaml /openapi.json get /pages/{id}/sharing
openapi: 3.0.0
info:
  title: Lava API
  description: >-
    NOTE: You are viewing the Lava API documentation for a test mode
    environment, which uses a different base url from the production
    environment. Lava API enables businesses to implement usage-based billing
    for AI services. This API allows tracking, managing, and billing for
    third-party AI API usage through a forwarding system.
  version: 1.0.0
  contact:
    name: Lava support
    url: https://www.lava.so/contact
servers:
  - url: https://api.lava.so/v1/
    description: Lava API v1
security: []
tags:
  - name: Authentication
  - name: Core Endpoints
  - name: Models
  - name: Services
  - name: Requests
  - name: Wallet
  - name: Payment Methods
  - name: Spend Keys
  - name: Usage
  - name: Checkout Sessions
  - name: Customers
  - name: Plans
  - name: Subscriptions
  - name: Meters
  - name: Webhooks
  - name: Secret Keys
  - name: Credit Bundles
  - name: Gateway Settings
  - name: News Data
  - name: Search
  - name: Enrich
  - name: Pages
paths:
  /pages/{id}/sharing:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - Pages
      summary: Inspect Page sharing
      description: >-
        Inspect the current audience, sharing revision, recipients and
        Editor-assignment capability. Recipient listing accepts cursor and limit
        (1–100). Only the Author or an independently admitted current Workspace
        admin can inspect sharing. Uses a validated person-attributed account
        key through Forward or the MCP metered path. Returns trace_id on every
        operation result. Guest email proof grants no management authority.
      operationId: pageSharinginspect
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
            maxLength: 36
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
      responses:
        '200':
          description: Current authorized projection or committed sharing receipt.
          content:
            application/json:
              schema:
                type: object
                properties:
                  revision:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  canonical_link:
                    type: string
                    format: uri
                  workspace_name:
                    type: string
                    nullable: true
                  audience:
                    type: object
                    properties:
                      general_access:
                        type: string
                        enum:
                          - author
                          - workspace
                          - anyone
                      cabinet:
                        type: string
                        enum:
                          - personal
                          - workspace
                      active_editors:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      active_named_recipients:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      workspace_role:
                        type: string
                        enum:
                          - viewer
                          - editor
                    required:
                      - general_access
                      - cabinet
                      - active_editors
                    additionalProperties: false
                  can_assign_editors:
                    type: boolean
                  supports_atomic_removal:
                    description: >-
                      Supports targeted removal of explicit access in one
                      transaction. Absence means unavailable.
                    type: boolean
                  can_set_workspace_role:
                    description: >-
                      Whether this manager can change the Workspace default,
                      including while public. Older servers without this
                      capability support role changes only under Workspace
                      General access.
                    type: boolean
                  can_remove_workspace:
                    description: >-
                      Whether this server supports moving a Workspace Page back
                      to the Author’s My Files.
                    type: boolean
                  can_add_workspace:
                    description: >-
                      Whether the manager can move this Personal Page to
                      Workspace Files while preserving its public link. Absence
                      means this operation is unavailable.
                    type: boolean
                  can_invite:
                    description: >-
                      Whether new email invitations and resends are enabled.
                      Absence means unavailable. Existing reads, revocation and
                      queued delivery remain available when false.
                    type: boolean
                  supports_saved_data:
                    type: boolean
                  viewers_can_interact:
                    type: boolean
                  is_author:
                    description: >-
                      Whether the current manager created this Page,
                      independently of Editor-assignment support.
                    type: boolean
                  author:
                    nullable: true
                    type: object
                    properties:
                      display_name:
                        type: string
                        nullable: true
                      viewer_grant_ids:
                        description: >-
                          Verified exact-email associations to recipients in
                          this response. Presentation only; absence means no
                          confirmed association.
                        type: array
                        items:
                          type: string
                    required:
                      - display_name
                    additionalProperties: false
                  editors:
                    type: array
                    items:
                      type: object
                      properties:
                        member_id:
                          type: string
                        display_name:
                          type: string
                          nullable: true
                        email:
                          type: string
                          nullable: true
                        viewer_grant_ids:
                          description: >-
                            Verified exact-email associations to recipients in
                            this response. Editor and Viewer contributions
                            remain independent.
                          type: array
                          items:
                            type: string
                      required:
                        - member_id
                        - display_name
                        - email
                      additionalProperties: false
                  recipients:
                    type: array
                    items:
                      type: object
                      properties:
                        grant_id:
                          type: string
                        email:
                          type: string
                        state:
                          type: string
                          enum:
                            - active
                            - stopped
                        invitation:
                          nullable: true
                          type: object
                          properties:
                            id:
                              type: string
                            state:
                              type: string
                              enum:
                                - queued
                                - provider_accepted
                                - failed
                                - unknown
                                - cancelled
                          required:
                            - id
                            - state
                          additionalProperties: false
                        member_id:
                          description: >-
                            Current owning-Workspace membership confirmed
                            through a unique verified email identity. Absence is
                            not proof of membership.
                          type: string
                        display_name:
                          type: string
                          nullable: true
                      required:
                        - grant_id
                        - email
                        - state
                        - invitation
                      additionalProperties: false
                  next_cursor:
                    type: string
                    nullable: true
                  trace_id:
                    type: string
                required:
                  - revision
                  - canonical_link
                  - audience
                  - can_assign_editors
                  - supports_saved_data
                  - viewers_can_interact
                  - author
                  - editors
                  - trace_id
                additionalProperties: false
        '400':
          description: 'invalid: Check the sharing fields and eligible member IDs.'
        '403':
          description: |-
            disabled: New Page invitations are not enabled for this account.

            forbidden: You cannot manage sharing for this Page.
        '404':
          description: 'not_found: Page unavailable.'
        '409':
          description: >-
            page_author_missing: This Page has no Author to return it to.


            editor_migration_pending: This Page’s Editor access is still being
            updated. Try the move again later.


            author_unavailable: The Page Author is unavailable. Restore
            membership before inviting.


            stale_revision: Sharing changed. Review your draft against the
            current audience before saving again.


            operation_mismatch: This operation ID was already used for a
            different change.


            ownership_changed: Page ownership changed. Inspect sharing again.
        '410':
          description: 'gone: Page unavailable.'
        '429':
          description: >-
            rate_limited: Invitation limit reached. Wait before inviting or
            resending.
        '503':
          description: >-
            recipient_identity_unavailable: The recipient’s verified identity
            could not be established. No access was changed.


            invitation_unavailable: Invitation limits could not be checked. Try
            again.


            membership_sync_pending: Workspace membership is being reconciled.
            Try again.


            authority_unavailable: Current Workspace authority could not be
            verified. Try again.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.