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.

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

Path parameters

session_idstring required

Query parameters

include_htmlboolean

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

authorizationstring nullable

Request body

document_idsstring[] required

Durable document ids (from GET /v1/documents) to open into the session.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.