---
title: "Open saved documents into a chat session (shared, never copied)."
method: POST
path: "/v1/sessions/{session_id}/documents/open"
tags: ["v1", "mcp", "sessions"]
---

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

`POST /v1/sessions/{session_id}/documents/open`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/sessions/{session_id}/documents/open`
- Auth: HTTP bearer

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.

## Path parameters

- `session_id` string, required

## Query parameters

- `include_html` boolean: 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.

## Headers

- `authorization` string, nullable

## Request body

- OpenDocumentsRequest
  - `document_ids` string[], required: Durable document ids (from GET /v1/documents) to open into the session.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)