Switch which document is focused in a multi-document session.

Make document_id the focused document (the editor's active document and the default edit target). Accepts either the session slot id OR the permanent document id (the UUID shown by list_documents/Files, returned as durable_document_id by list_session_documents). Persists the outgoing focused document into the session's document map and returns the now-focused document's HTML.

post/v1/sessions/{session_id}/documents/{document_id}/focus

Request

Base URL: https://api.superdocs.app
URL: https://api.superdocs.app/v1/sessions/{session_id}/documents/{document_id}/focus
Auth: HTTP bearer

Path parameters

session_idstring required

document_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

Response

Successful Response

unknown required

Changes

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