{
  "openapi": "3.1.0",
  "info": {
    "title": "AssetVault AI API",
    "description": "AI-powered home inventory and insurance documentation platform API. Manage home inventories, process insurance claims, analyze coverage gaps, and generate AI-powered insurance reports.",
    "version": "1.0.0",
    "contact": {
      "name": "AssetVault AI Support",
      "email": "support@assetvaultai.com",
      "url": "https://assetvaultai.com/Help"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://assetvaultai.com/TermsAndConditions"
    }
  },
  "servers": [
    {
      "url": "https://assetvaultai.com/api",
      "description": "Production API"
    }
  ],
  "paths": {
    "/inventory": {
      "get": {
        "operationId": "listInventory",
        "summary": "List inventory items",
        "description": "Retrieve the authenticated user's home inventory items with optional filtering by directory, category, or value range.",
        "tags": ["Inventory"],
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "List of inventory items" },
          "401": { "description": "Unauthorized" }
        }
      }
    },
    "/claims": {
      "get": {
        "operationId": "listClaims",
        "summary": "List insurance claims",
        "description": "Retrieve all insurance claims for the authenticated user.",
        "tags": ["Claims"],
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "List of claims" },
          "401": { "description": "Unauthorized" }
        }
      },
      "post": {
        "operationId": "createClaim",
        "summary": "Create a new insurance claim",
        "description": "Start a new insurance claim with incident details and affected items.",
        "tags": ["Claims"],
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "201": { "description": "Claim created" },
          "401": { "description": "Unauthorized" }
        }
      }
    },
    "/coverage/analyze": {
      "post": {
        "operationId": "analyzeCoverage",
        "summary": "Analyze insurance coverage gaps",
        "description": "Compare total inventory value against coverage limit and identify uninsured assets and high-risk categories.",
        "tags": ["Coverage"],
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "200": { "description": "Coverage gap analysis results" },
          "401": { "description": "Unauthorized" }
        }
      }
    },
    "/market-value": {
      "get": {
        "operationId": "getMarketValue",
        "summary": "Get current market value estimate",
        "description": "Get AI-powered current replacement value estimate for any item using real-time market data.",
        "tags": ["Valuation"],
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          {
            "name": "item",
            "in": "query",
            "required": true,
            "schema": { "type": "string" },
            "description": "Item name or description to look up"
          }
        ],
        "responses": {
          "200": { "description": "Market value estimate" },
          "401": { "description": "Unauthorized" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "tags": [
    { "name": "Inventory", "description": "Home inventory management" },
    { "name": "Claims", "description": "Insurance claims processing" },
    { "name": "Coverage", "description": "Coverage gap analysis" },
    { "name": "Valuation", "description": "Market value and depreciation" }
  ]
}