{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vee3-io/json-schema/vee3-io-upload-file-request-schema.json",
  "title": "UploadFileRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vee3-io-files-api-openapi.yml#/components/schemas/UploadFileRequest",
  "properties": {
    "file_name": {
      "type": "string",
      "maxLength": 255,
      "title": "File Name",
      "description": "Desired file name or path for the uploaded file. Use folder/subfolder/.../file_name to organize files in folders. Extension is optional and is replaced based on detected file type. Do not use '..' or absolute paths."
    },
    "retention_days": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 90.0,
          "minimum": 1.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Retention Days",
      "description": "How many days to keep the file after upload completes. Default 7. Billing uses size and this retention.",
      "default": 7
    },
    "existing_files": {
      "type": "string",
      "enum": [
        "stop",
        "continue",
        "replace"
      ],
      "title": "Existing Files",
      "description": "What to do when a stored file already uses the same name. 'stop' (default) fails on the first duplicate. 'continue' skips duplicates and keeps uploading remaining files. 'replace' overwrites duplicated stored files.",
      "default": "stop"
    }
  },
  "type": "object",
  "required": [
    "file_name"
  ]
}