{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/superdocs-app/json-schema/superdocs-app-upload-url-request-schema.json",
  "title": "UploadUrlRequest",
  "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/UploadUrlRequest",
  "properties": {
    "filename": {
      "type": "string",
      "maxLength": 255,
      "title": "Filename",
      "description": "Original filename including extension (e.g. 'contract.docx'). Used downstream for file-type detection."
    },
    "content_type": {
      "type": "string",
      "maxLength": 200,
      "title": "Content Type",
      "description": "MIME type the agent will PUT with (e.g. 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' for .docx)."
    },
    "size_bytes": {
      "type": "integer",
      "maximum": 104857600.0,
      "exclusiveMinimum": 0.0,
      "title": "Size Bytes",
      "description": "File size in bytes. Must be > 0 and <= 104857600 (100 MB)."
    },
    "purpose": {
      "type": "string",
      "enum": [
        "document",
        "attachment",
        "export-html"
      ],
      "title": "Purpose",
      "description": "What this file will be used for. 'document' = the active editable doc; 'attachment' = read-only AI-searchable reference; 'export-html' = HTML payload destined for /v1/documents/export (large-export upload flow, for documents above ~25 MB).",
      "default": "document"
    }
  },
  "type": "object",
  "required": [
    "filename",
    "content_type",
    "size_bytes"
  ]
}