---
title: "Start a new chat session and open documents into it in one call."
method: POST
path: "/v1/sessions/init"
tags: ["v1", "mcp", "sessions"]
---

# Start a new chat session and open documents into it in one call.

`POST /v1/sessions/init`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/sessions/init`
- Auth: HTTP bearer

Create a session AND open N saved documents into it in ONE call (the documents are SHARED,
never copied — the same cross-session behavior as /documents/open). The web UI passes its own
session_id so its session model stays consistent; an MCP/API integrator can omit it and the
server mints one — the one-call way to start a session with documents already open. With no
document_ids it just returns a fresh, empty session. The open semantics (first document focused,
durable binding, returned roster) are identical to /documents/open.

## 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

- InitSessionRequest
  - `document_ids` string[], nullable: Durable document ids (from GET /v1/documents) to open into the brand-new session. Omit/empty to start an empty session.
  - `session_id` string, nullable: Optional client-chosen session id (the web UI passes its own so its session model stays consistent). Omit and the server mints one — the one-call way for an MCP/API integrator to start a session with documents already open.

## 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)