Chat API

POST /v1/chat

Authorization: Bearer hi_live_YOUR_API_KEY
Content-Type: application/json

curl -X POST https://api.homeinsightai.com/v1/chat \
  -H "Authorization: Bearer hi_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analysis_id": "ana_abc123xyz",
    "query": "What are the issues with the roof?",
    "include_cost_estimate": true
  }'

{
  "message_id": "msg_xyz789",
  "query": "What are the issues with the roof?",
  "answer": "The inspection report identified several roof issues:\n\n1. **Missing shingles on north slope**: Approximately 15-20 asphalt shingles are missing, exposing the underlayment to weather damage.\n\n2. **Damaged flashing around chimney**: The metal flashing shows signs of rust and improper sealing.\n\n3. **Granule loss on asphalt shingles**: Significant granule loss observed across multiple sections, indicating the roof is nearing the end of its lifespan (typically 20-25 years for asphalt shingles).",
  "citations": [
    {
      "file": "inspection_report.pdf",
      "page": 9,
      "snippet": "North-facing slope shows missing shingles (est. 15-20)"
    },
    {
      "file": "inspection_report.pdf",
      "page": 10,
      "snippet": "Chimney flashing exhibits rust and improper sealing"
    },
    {
      "file": "inspection_report.pdf",
      "page": 9,
      "snippet": "Granule loss observed on approximately 40% of visible shingles"
    }
  ],
  "estimated_cost": {
    "total": {
      "low": 2500,
      "high": 4500,
      "currency": "USD"
    },
    "breakdown": [
      {
        "item": "Shingle replacement (north slope)",
        "quantity": "20 shingles",
        "cost": { "low": 800, "high": 1200 }
      },
      {
        "item": "Chimney flashing repair",
        "quantity": "1 chimney",
        "cost": { "low": 600, "high": 900 }
      },
      {
        "item": "Full roof replacement (recommended within 2-3 years)",
        "quantity": "1 roof",
        "cost": { "low": 8500, "high": 15000 },
        "notes": "Optional - for long-term planning"
      }
    ]
  },
  "related_questions": [
    "What is the estimated lifespan of the current roof?",
    "Are there any structural issues related to the roof?",
    "Should I negotiate the roof repairs with the seller?"
  ],
  "created_at": "2025-11-27T12:05:30Z"
}

GET /v1/chat/:analysis_id/history

curl "https://api.homeinsightai.com/v1/chat/ana_abc123xyz/history?limit=10" \
  -H "Authorization: Bearer hi_live_YOUR_API_KEY"

{
  "analysis_id": "ana_abc123xyz",
  "messages": [
    {
      "message_id": "msg_001",
      "query": "What are the major issues?",
      "answer": "The inspection identified 12 issues total...",
      "created_at": "2025-11-27T12:00:00Z"
    },
    {
      "message_id": "msg_002",
      "query": "What are the issues with the roof?",
      "answer": "The inspection report identified several roof issues...",
      "created_at": "2025-11-27T12:05:30Z"
    }
  ],
  "meta": {
    "total_count": 2,
    "has_more": false
  }
}

DELETE /v1/chat/:analysis_id

curl -X DELETE https://api.homeinsightai.com/v1/chat/ana_abc123xyz \
  -H "Authorization: Bearer hi_live_YOUR_API_KEY"

{
  "analysis_id": "ana_abc123xyz",
  "messages_deleted": 12,
  "deleted_at": "2025-11-27T12:30:00Z"
}

POST /v1/chat/stream

curl -X POST https://api.homeinsightai.com/v1/chat/stream \
  -H "Authorization: Bearer hi_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "analysis_id": "ana_abc123xyz",
    "query": "What are the issues with the roof?"
  }'

event: message
data: {"type": "start", "message_id": "msg_xyz789"}

event: message
data: {"type": "content", "delta": "The inspection "}

event: message
data: {"type": "content", "delta": "report identified "}

event: message
data: {"type": "content", "delta": "several roof issues:\n\n"}

event: message
data: {"type": "citation", "file": "inspection_report.pdf", "page": 9}

event: message
data: {"type": "content", "delta": "1. Missing shingles..."}

event: message
data: {"type": "done", "message_id": "msg_xyz789"}

{
  "include_cost_estimate": true  // Adds ~2s to response time
}

{
  "session_id": "sess_abc123",
  "query": "What about the plumbing?"  // Maintains context
}

// Display suggested questions
response.related_questions.forEach(question => {
  console.log(`- ${question}`)
})

// Example citation UI
citations.forEach(cit => {
  console.log(`Source: ${cit.file}, Page ${cit.page}`)
  console.log(`"${cit.snippet}"`)
})

{
  "error": {
    "code": "analysis_not_ready",
    "message": "Analysis is still processing. Please try again in 30 seconds.",
    "retry_after": 30
  }
}

{
  "error": {
    "code": "invalid_query",
    "message": "Query cannot be empty"
  }
}

{
  "answer": "I couldn't find specific information about that in the uploaded documents. Could you rephrase your question or ask about something else?",
  "citations": [],
  "confidence": "low"
}