> ## 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.

# Replace Page Editors

> Replacement of eligible Workspace Editors by the Author or an admitted owning-Workspace admin, with operation_id, expected_revision and member_ids. Independent Editor access survives General access narrowing. Does not invite by email or alter publication or cabinet. 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 put /pages/{id}/sharing/editors
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/editors:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
    put:
      tags:
        - Pages
      summary: Replace Page Editors
      description: >-
        Replacement of eligible Workspace Editors by the Author or an admitted
        owning-Workspace admin, with operation_id, expected_revision and
        member_ids. Independent Editor access survives General access narrowing.
        Does not invite by email or alter publication or cabinet. 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: pageSharingeditors
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                operation_id:
                  type: string
                  minLength: 1
                  maxLength: 128
                  pattern: ^[A-Za-z0-9_-]+$
                expected_revision:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                member_ids:
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 36
              required:
                - operation_id
                - expected_revision
                - member_ids
              additionalProperties: false
      responses:
        '200':
          description: Current authorized projection or committed sharing receipt.
          content:
            application/json:
              schema:
                type: object
                properties:
                  operation_id:
                    type: string
                  committed_revision:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  canonical_link:
                    type: string
                    format: uri
                  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
                  granted:
                    type: array
                    items:
                      type: string
                  revoked:
                    type: array
                    items:
                      type: string
                  invitations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        state:
                          type: string
                          enum:
                            - queued
                            - provider_accepted
                            - failed
                            - unknown
                            - cancelled
                      required:
                        - id
                        - state
                      additionalProperties: false
                  current:
                    nullable: true
                    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
                    required:
                      - revision
                      - canonical_link
                      - audience
                      - can_assign_editors
                      - supports_saved_data
                      - viewers_can_interact
                      - author
                      - editors
                    additionalProperties: false
                  trace_id:
                    type: string
                required:
                  - operation_id
                  - committed_revision
                  - canonical_link
                  - audience
                  - current
                  - 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.