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

# Open saved documents into a chat session (shared, never copied).

> Load one or more SAVED documents into a session as editable tabs. The SAME durable
document is attached (never copied), so edits flow back to the one shared row with
cross-session soft-collaboration. The first listed document is focused. Returns the
refreshed document roster so the client can render tabs immediately.



## OpenAPI

````yaml /openapi.json post /v1/sessions/{session_id}/documents/open
openapi: 3.1.0
info:
  title: Universal Document AI API
  description: AI-powered document editing with multi-tenant organization support
  version: 2.0.0
servers: []
security: []
paths:
  /v1/sessions/{session_id}/documents/open:
    post:
      tags:
        - v1
        - mcp
        - sessions
      summary: Open saved documents into a chat session (shared, never copied).
      description: >-
        Load one or more SAVED documents into a session as editable tabs. The
        SAME durable

        document is attached (never copied), so edits flow back to the one
        shared row with

        cross-session soft-collaboration. The first listed document is focused.
        Returns the

        refreshed document roster so the client can render tabs immediately.
      operationId: open_documents
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            title: Session Id
        - name: include_html
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Include each document's full reassembled HTML body. Default false
              (token-light — recommended for AI agents enumerating or switching
              tabs): returns only ids, title, section count, focused flag, and
              page setup, omitting the body which can be hundreds of KB per
              document. The web app passes true to render document content.
            default: false
            title: Include Html
          description: >-
            Include each document's full reassembled HTML body. Default false
            (token-light — recommended for AI agents enumerating or switching
            tabs): returns only ids, title, section count, focused flag, and
            page setup, omitting the body which can be hundreds of KB per
            document. The web app passes true to render document content.
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenDocumentsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    OpenDocumentsRequest:
      properties:
        document_ids:
          items:
            type: string
          type: array
          title: Document Ids
          description: >-
            Durable document ids (from GET /v1/documents) to open into the
            session.
      type: object
      required:
        - document_ids
      title: OpenDocumentsRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````