{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/superdocs-app/json-schema/superdocs-app-process-upload-request-schema.json",
  "title": "ProcessUploadRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/superdocs-app-uploads-api-openapi.yml#/components/schemas/ProcessUploadRequest",
  "properties": {
    "session_id": {
      "type": "string",
      "maxLength": 256,
      "pattern": "^[a-zA-Z0-9_\\-\\.]+$",
      "title": "Session Id",
      "description": "Session ID to load this document/attachment into. Must match the chat/async session-id format — letters, digits, '_', '-', '.' only (no ':'); max 256 chars."
    },
    "filename": {
      "type": "string",
      "maxLength": 255,
      "title": "Filename",
      "description": "Same filename passed to request_upload_url."
    },
    "parse_mode": {
      "type": "string",
      "enum": [
        "document",
        "attachment"
      ],
      "title": "Parse Mode",
      "description": "'document' = parse and load as the active editable doc; 'attachment' = process asynchronously as AI-searchable reference (returns job_id to poll).",
      "default": "document"
    },
    "return_html": {
      "type": "boolean",
      "title": "Return Html",
      "description": "When false (default), the response is compact — metadata only (chunks_count, version_id, page_setup), no document body — to keep your context small; the document is loaded into the session and you edit it via chat. Set true only if you actually need the parsed HTML returned inline.",
      "default": false
    },
    "open_mode": {
      "type": "string",
      "enum": [
        "replace",
        "new_tab",
        "new_focused",
        "background"
      ],
      "title": "Open Mode",
      "description": "parse_mode='document' only. 'replace' (default): the document replaces the session's focused document. 'new_tab' / 'new_focused': it opens as an additional document and becomes the focused one. 'background': it opens as an additional document without changing which document is focused.",
      "default": "replace"
    }
  },
  "type": "object",
  "required": [
    "session_id",
    "filename"
  ]
}