v1
mcp

Get a saved document's detail, structure outline, and the chats that used it.

One saved document's metadata plus a STRUCTURE outline and the chat sessions that have it open (prior-chats-per-file). Owner-scoped — 404 if the document isn't yours.

structure (always included, token-light, NON-BILLABLE) is the cheap verify step after any edit: headings (level + text + position), section_count (heading-anchored), block_count (editable chunks), media (image/diagram counts). It answers "did my edit land?" for free — never export a whole document just to check its structure. Pass include_html=true only when you need the body.

get/v1/documents/{document_id}

Request

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

Path parameters

document_idstring required

Query parameters

include_htmlboolean

When true, also returns the document's full reassembled HTML body (html), plus its page_setup and version_id. Default false returns metadata + structure + prior-chats only, keeping the response token-light. This is the by-id way to read a saved document's body without opening it into a session.

Headers

authorizationstring nullable

Response

Successful Response

unknown required

Changes

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