Edit, draft, or restructure a document using natural language. Preserves tables, styling, and formatting.

Synchronous AI chat that can rewrite specific paragraphs, add or remove table rows, restructure sections, generate new content from templates, or transform an entire document. Pass document_html only to load or replace the document; once a session holds a document the server persists it across turns, so omit it on follow-up turns. To replace the whole document with EXACT content you already hold, pass that content in document_html (a verbatim load — the AI never re-types it) or upload it via upload_document_base64; describing the content only in message makes the AI author it, which can drift from your text. Returns AI response text plus structural document changes (HTML edits, additions, deletions) with chunk IDs. One billable operation per document-modifying turn; very large multi-section edits bill one operation per 25 sections changed. For long-running edits or human-in-the-loop approval, use chat_async. Optional: model_tier (core/turbo/pro/max), thinking_depth (fast/balanced/deep), image_attachments for multimodal vision. RECOMMENDED for AI agents working with large documents (>20 pages): set response_mode=‘compact’ to skip the full HTML in the response (the AI returns only per-section diffs in chunk_diffs) and save thousands of tokens per turn. To read sections in compact mode, just send a natural-language request like ‘show me the force majeure section’ — the AI returns the content in the reply text. Always use natural language to describe what you want; the AI handles all internal section lookups.

POST

chat

curl --request POST \
  --url https://api.example.com/v1/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "session_id": "<string>",
  "document_html": "<string>",
  "user_id": "<string>",
  "image_attachments": [
    {
      "id": "<string>",
      "name": "<string>",
      "base64Data": "<string>",
      "mimeType": "<string>",
      "size": 123
    }
  ],
  "model_tier": "<string>",
  "thinking_depth": "<string>",
  "approval_mode": "<string>",
  "response_mode": "full",
  "cursor_context": {},
  "document_id": "<string>",
  "window_id": "<string>",
  "cross_session_memory": true,
  "cross_session_search": true,
  "cross_session_memory_key": "<string>",
  "cross_session_scope": [
    "<string>"
  ],
  "touched_chunk_ids": [
    "<string>"
  ],
  "deleted_part_chunk_ids": [
    "<string>"
  ]
}
'

import requests

url = "https://api.example.com/v1/chat"

payload = {
    "message": "<string>",
    "session_id": "<string>",
    "document_html": "<string>",
    "user_id": "<string>",
    "image_attachments": [
        {
            "id": "<string>",
            "name": "<string>",
            "base64Data": "<string>",
            "mimeType": "<string>",
            "size": 123
        }
    ],
    "model_tier": "<string>",
    "thinking_depth": "<string>",
    "approval_mode": "<string>",
    "response_mode": "full",
    "cursor_context": {},
    "document_id": "<string>",
    "window_id": "<string>",
    "cross_session_memory": True,
    "cross_session_search": True,
    "cross_session_memory_key": "<string>",
    "cross_session_scope": ["<string>"],
    "touched_chunk_ids": ["<string>"],
    "deleted_part_chunk_ids": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: '<string>',
    session_id: '<string>',
    document_html: '<string>',
    user_id: '<string>',
    image_attachments: [
      {
        id: '<string>',
        name: '<string>',
        base64Data: '<string>',
        mimeType: '<string>',
        size: 123
      }
    ],
    model_tier: '<string>',
    thinking_depth: '<string>',
    approval_mode: '<string>',
    response_mode: 'full',
    cursor_context: {},
    document_id: '<string>',
    window_id: '<string>',
    cross_session_memory: true,
    cross_session_search: true,
    cross_session_memory_key: '<string>',
    cross_session_scope: ['<string>'],
    touched_chunk_ids: ['<string>'],
    deleted_part_chunk_ids: ['<string>']
  })
};

fetch('https://api.example.com/v1/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/chat",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => '<string>',
    'session_id' => '<string>',
    'document_html' => '<string>',
    'user_id' => '<string>',
    'image_attachments' => [
        [
                'id' => '<string>',
                'name' => '<string>',
                'base64Data' => '<string>',
                'mimeType' => '<string>',
                'size' => 123
        ]
    ],
    'model_tier' => '<string>',
    'thinking_depth' => '<string>',
    'approval_mode' => '<string>',
    'response_mode' => 'full',
    'cursor_context' => [
        
    ],
    'document_id' => '<string>',
    'window_id' => '<string>',
    'cross_session_memory' => true,
    'cross_session_search' => true,
    'cross_session_memory_key' => '<string>',
    'cross_session_scope' => [
        '<string>'
    ],
    'touched_chunk_ids' => [
        '<string>'
    ],
    'deleted_part_chunk_ids' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/chat"

	payload := strings.NewReader("{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/v1/chat")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/chat")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "response": "<string>",
  "session_id": "<string>",
  "document_changes": {
    "updated_html": "<string>",
    "version_id": "<string>",
    "changes_summary": "<string>",
    "requires_approval": true,
    "pending_changes": [
      {
        "change_id": "<string>",
        "operation": "<string>",
        "chunk_id": "<string>",
        "document_id": "<string>",
        "old_html": "<string>",
        "new_html": "<string>",
        "ai_explanation": "<string>"
      }
    ],
    "changes": [
      {}
    ],
    "chunk_diffs": [
      {
        "change_id": "<string>",
        "operation": "<string>",
        "chunk_id": "<string>",
        "document_id": "<string>",
        "old_html": "<string>",
        "new_html": "<string>",
        "ai_explanation": "<string>"
      }
    ]
  },
  "usage": {
    "monthly_used": 123,
    "monthly_limit": 123,
    "monthly_remaining": 123,
    "was_billable": true,
    "ops_charged": 123,
    "quota_exhausted": true,
    "subscription_tier": "<string>",
    "bucket_used": "<string>",
    "redemption_id": "<string>",
    "promotions": [
      {
        "redemption_id": "<string>",
        "name": "<string>",
        "ops_remaining": 123,
        "ops_granted": 123,
        "expires_at": "<string>"
      }
    ]
  },
  "hint": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization

string | null

Body

application/json

Send a message to the AI assistant with optional document context.

message

string

required

Your message to the AI assistant.

Maximum string length: 100000

session_id

string

required

Unique session identifier. Reuse to continue a conversation.

Maximum string length: 256

Pattern: ^[a-zA-Z0-9_\-\.]+$

document_html

string | null

Current document HTML. OMIT this when the session already holds the document — the server persists it across turns, so you don't re-send it every turn; pass it only to load new content or replace the document wholesale (a verbatim load — the AI never re-types content passed here). Include data-chunk-id attributes on elements to enable targeted AI edits.

Maximum string length: 50000000

user_id

string | null

User identifier. Automatically set from authentication — typically omit this.

Maximum string length: 256

image_attachments

ImageAttachmentData · object[] | null

Inline images for vision-based analysis (base64-encoded).

Maximum array length: 20

Show child attributes

model_tier

string | null

AI model to use: 'core' (default, fast), 'turbo' (fastest), 'pro' (advanced reasoning), 'max' (most capable).

thinking_depth

string | null

Reasoning depth: 'fast', 'balanced' (default), or 'deep'. Controls how much analysis the AI performs.

approval_mode

string | null

Change review mode: 'approve_all' (default, auto-applies changes) or 'ask_every_time' (pauses for your review).

response_mode

enum<string> | null

default:full

Response shape control. 'full' (default) returns the complete updated document HTML — required by web app editors and recommended for small documents (<20 pages). 'compact' (recommended for AI agents editing large documents) suppresses the full HTML and returns only per-section diffs (chunk_diffs) for changed sections, saving thousands of tokens per turn. To read sections in compact mode, just send a natural-language request like 'show me the force majeure section' — the AI returns the content in the chat reply text.

Available options:

full,

compact

cursor_context

Cursor Context · object | null

Editor cursor context at message time, used to default the insert location for new images, diagrams, or sections when the user's prompt doesn't name a position. Shape: {chunk_id: str, pos_in_chunk?: int, text_before?: str, text_after?: str}. Omit when the user typed in chat without focusing the editor first.

document_id

string | null

Target a specific open document by id (ids come from /v1/sessions/{session_id}/documents). Omit to target the focused document (default — unchanged single-document behaviour). When set, that document becomes the focus for this turn.

window_id

string | null

Optional identifier for the client window (set by the web app) so concurrent edits from two windows of the same chat are merged rather than overwritten. Agents/API may omit.

cross_session_memory

boolean | null

When true, the AI carries a private rolling memory of context across THIS account's chats (off by default). Per-request override of your saved Settings default.

cross_session_search

boolean | null

When true, the AI may search your PAST chats and documents on demand to reuse prior work and open a found document (off by default). Per-request override of your saved Settings default; never affects the always-on search of the open document.

cross_session_memory_key

string | null

Optional per-request id of YOUR end-customer so the cross-session memory note is kept in a separate file per end-customer. Omit for one account-level note (the default / B2C).

Maximum string length: 256

cross_session_scope

string[] | null

Optional list of session ids to restrict cross-session SEARCH to (e.g. one end-customer's sessions). Omit to search all of this account's sessions. Only narrows within the API-key owner; ignored unless cross_session_search is on.

Maximum array length: 2000

touched_chunk_ids

string[] | null

Optional list of chunk ids (data-chunk-id values) the user actually edited since the last sync, sent alongside document_html. When present, a chunk NOT in this list whose text is unchanged keeps its stored formatting byte-for-byte even if the client serialized it differently (protects styling from editor round-trip loss). Chunks in the list — and any chunk whose text changed — always take the submitted content. Omit for the default behavior (any differing chunk is treated as an edit).

Maximum array length: 50000

deleted_part_chunk_ids

string[] | null

Optional list of chunk ids (data-chunk-id values) of OUT-OF-FLOW part sections (page headers/footers, footnote/endnote bodies, comments) to delete explicitly, sent alongside document_html. Out-of-flow parts absent from document_html are always KEPT — an editor view not containing them is their normal state, never a deletion — so removing one requires naming its id here. Ids that are not stored out-of-flow parts are ignored (in-flow content keeps the default behavior). Omit when deleting nothing.

Maximum array length: 50000

Response

Successful Response

AI response with optional document changes and usage data.

response

string

required

AI assistant's response text.

session_id

string

required

Session identifier for this conversation.

document_changes

DocumentChanges · object | null

Document modifications made by the AI. Present only when the document was changed.

Show child attributes

usage

UsageInfo · object | null

Operation usage data. Present for authenticated users with usage tracking.

Show child attributes

hint

Hint · object | null

Advisory guidance for API callers (additive; absent on most responses). Currently: prefer_chat_async_for_large_generations — this turn ran long enough that the same work submitted via POST /v1/chat/async would be safer (no gateway timeout risk) and reports progress.

List your active document editing sessions to resume or audit prior work.Returns sessions sorted by most recent activity, with message counts and last-updated timestamps. Each session represents one document with full edit history and AI conversation persisted server-side. Use to find a previous editing context to resume (then call get_session_history) or to audit your workspace.

Edit, draft, or restructure a document using natural language. Preserves tables, styling, and formatting.

curl --request POST \
  --url https://api.example.com/v1/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "session_id": "<string>",
  "document_html": "<string>",
  "user_id": "<string>",
  "image_attachments": [
    {
      "id": "<string>",
      "name": "<string>",
      "base64Data": "<string>",
      "mimeType": "<string>",
      "size": 123
    }
  ],
  "model_tier": "<string>",
  "thinking_depth": "<string>",
  "approval_mode": "<string>",
  "response_mode": "full",
  "cursor_context": {},
  "document_id": "<string>",
  "window_id": "<string>",
  "cross_session_memory": true,
  "cross_session_search": true,
  "cross_session_memory_key": "<string>",
  "cross_session_scope": [
    "<string>"
  ],
  "touched_chunk_ids": [
    "<string>"
  ],
  "deleted_part_chunk_ids": [
    "<string>"
  ]
}
'

import requests

url = "https://api.example.com/v1/chat"

payload = {
    "message": "<string>",
    "session_id": "<string>",
    "document_html": "<string>",
    "user_id": "<string>",
    "image_attachments": [
        {
            "id": "<string>",
            "name": "<string>",
            "base64Data": "<string>",
            "mimeType": "<string>",
            "size": 123
        }
    ],
    "model_tier": "<string>",
    "thinking_depth": "<string>",
    "approval_mode": "<string>",
    "response_mode": "full",
    "cursor_context": {},
    "document_id": "<string>",
    "window_id": "<string>",
    "cross_session_memory": True,
    "cross_session_search": True,
    "cross_session_memory_key": "<string>",
    "cross_session_scope": ["<string>"],
    "touched_chunk_ids": ["<string>"],
    "deleted_part_chunk_ids": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: '<string>',
    session_id: '<string>',
    document_html: '<string>',
    user_id: '<string>',
    image_attachments: [
      {
        id: '<string>',
        name: '<string>',
        base64Data: '<string>',
        mimeType: '<string>',
        size: 123
      }
    ],
    model_tier: '<string>',
    thinking_depth: '<string>',
    approval_mode: '<string>',
    response_mode: 'full',
    cursor_context: {},
    document_id: '<string>',
    window_id: '<string>',
    cross_session_memory: true,
    cross_session_search: true,
    cross_session_memory_key: '<string>',
    cross_session_scope: ['<string>'],
    touched_chunk_ids: ['<string>'],
    deleted_part_chunk_ids: ['<string>']
  })
};

fetch('https://api.example.com/v1/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/chat",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => '<string>',
    'session_id' => '<string>',
    'document_html' => '<string>',
    'user_id' => '<string>',
    'image_attachments' => [
        [
                'id' => '<string>',
                'name' => '<string>',
                'base64Data' => '<string>',
                'mimeType' => '<string>',
                'size' => 123
        ]
    ],
    'model_tier' => '<string>',
    'thinking_depth' => '<string>',
    'approval_mode' => '<string>',
    'response_mode' => 'full',
    'cursor_context' => [
        
    ],
    'document_id' => '<string>',
    'window_id' => '<string>',
    'cross_session_memory' => true,
    'cross_session_search' => true,
    'cross_session_memory_key' => '<string>',
    'cross_session_scope' => [
        '<string>'
    ],
    'touched_chunk_ids' => [
        '<string>'
    ],
    'deleted_part_chunk_ids' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/chat"

	payload := strings.NewReader("{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/v1/chat")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/chat")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"<string>\",\n  \"session_id\": \"<string>\",\n  \"document_html\": \"<string>\",\n  \"user_id\": \"<string>\",\n  \"image_attachments\": [\n    {\n      \"id\": \"<string>\",\n      \"name\": \"<string>\",\n      \"base64Data\": \"<string>\",\n      \"mimeType\": \"<string>\",\n      \"size\": 123\n    }\n  ],\n  \"model_tier\": \"<string>\",\n  \"thinking_depth\": \"<string>\",\n  \"approval_mode\": \"<string>\",\n  \"response_mode\": \"full\",\n  \"cursor_context\": {},\n  \"document_id\": \"<string>\",\n  \"window_id\": \"<string>\",\n  \"cross_session_memory\": true,\n  \"cross_session_search\": true,\n  \"cross_session_memory_key\": \"<string>\",\n  \"cross_session_scope\": [\n    \"<string>\"\n  ],\n  \"touched_chunk_ids\": [\n    \"<string>\"\n  ],\n  \"deleted_part_chunk_ids\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "response": "<string>",
  "session_id": "<string>",
  "document_changes": {
    "updated_html": "<string>",
    "version_id": "<string>",
    "changes_summary": "<string>",
    "requires_approval": true,
    "pending_changes": [
      {
        "change_id": "<string>",
        "operation": "<string>",
        "chunk_id": "<string>",
        "document_id": "<string>",
        "old_html": "<string>",
        "new_html": "<string>",
        "ai_explanation": "<string>"
      }
    ],
    "changes": [
      {}
    ],
    "chunk_diffs": [
      {
        "change_id": "<string>",
        "operation": "<string>",
        "chunk_id": "<string>",
        "document_id": "<string>",
        "old_html": "<string>",
        "new_html": "<string>",
        "ai_explanation": "<string>"
      }
    ]
  },
  "usage": {
    "monthly_used": 123,
    "monthly_limit": 123,
    "monthly_remaining": 123,
    "was_billable": true,
    "ops_charged": 123,
    "quota_exhausted": true,
    "subscription_tier": "<string>",
    "bucket_used": "<string>",
    "redemption_id": "<string>",
    "promotions": [
      {
        "redemption_id": "<string>",
        "name": "<string>",
        "ops_remaining": 123,
        "ops_granted": 123,
        "expires_at": "<string>"
      }
    ]
  },
  "hint": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

v1

users

promo

uploads

agents

API Reference

mcp

Edit, draft, or restructure a document using natural language. Preserves tables, styling, and formatting.

Authorizations

Headers

Body

Response