Complete API Reference

curl -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "YOUR_TENANT_ID",
    "images": [
      "https://example.com/chair.jpg",
      "https://example.com/table.jpg"
    ]
  }' \
  http://localhost:3000/api/v1/estimator/analyze

# Example response stream:
# data: {"type":"text-delta","delta":"I can see "}
# data: {"type":"data-status-update","status":"Analyzing images..."}
# data: {"type":"data-manageItems","items":[{"name":"Chair","dimensions":{"length":50,"width":50,"height":90},"volume":0.225}]}
# data: {"type":"data-recommendation","recommendationDetails":{"recommendedBox":"Medium","totalVolume":0.5}}

# Get audit logs for a specific file
curl -H "x-api-key: YOUR_API_KEY" \  "https://api.example.com/api/v1/tenants/YOUR_ID/store/audit?assetId=FILE_ID"

# Response:
{
  "success": true,
  "data": {
    "logs": [
      {
        "id": "log_123",
        "event": "sync_completed",
        "file_id": "asset_abc",
        "file_name": "pricing.pdf",
        "status": "success",
        "details": {
          "google_file_id": "files/xyz",
          "processing_time_ms": 28500
        },
        "created_at": "2026-01-14T10:05:30Z"
      },
      {
        "id": "log_124",
        "event": "sync_started",
        "file_id": "asset_abc",
        "status": "in_progress",
        "created_at": "2026-01-14T10:05:01Z"
      }
    ],
    "total": 2
  }
}

# Get all audit logs for tenant (paginated)
curl -H "x-api-key: YOUR_API_KEY" \  "https://api.example.com/api/v1/tenants/YOUR_ID/store/audit?limit=50&offset=0"

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "role": "member"
  }' \
  http://localhost:3000/api/v1/tenants/{id}/accounts

# Roles: admin, member, viewer
# admin  → admin, read, write, delete (can create API keys)
# member → read, write (cannot create API keys)
# viewer → read only

curl -X POST \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{
    "name": "Production API Key",
    "scopes": ["chat:create", "chat:read", "file:read", "file:upload"]
  }' \  https://api.example.com/api/v1/tenants/YOUR_TENANT_ID/api-keys

# Response (201 Created):
{
  "success": true,
  "data": {
    "id": "key_new123",
    "apiKey": "sk_live_a1b2c3d4e5f6g7h8i9j0...",
    "name": "Production API Key",
    "scopes": ["chat:create", "chat:read", "file:read", "file:upload"],
    "created_at": "2026-01-14T12:00:00Z"
  }
}

⚠️  CRITICAL: Save the apiKey immediately!
   It will NEVER be shown again.

curl -X PUT \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{
    "newPassword": "SecurePass123!@#",
    "confirmPassword": "SecurePass123!@#"
  }' \  https://api.example.com/api/v1/tenants/YOUR_ID/asset-auth/password

# Response (200 OK):
{
  "success": true,
  "data": {
    "message": "Password updated successfully",
    "assetManager": {
      "email": "tenant-abc12345@mystorage.asia",
      "loginUrl": "https://app.example.com"
    }
  }
}

# Error Response (400 - Weak Password):
{
  "success": false,
  "error": {
    "code": "WEAK_PASSWORD",
    "message": "Password must contain uppercase, lowercase, number, and special character."
  }
}

curl https://api.example.com/api/v1/ready

# Response (200 OK - Ready):
{
  "status": "ready",
  "service": "convo-agents-api",
  "timestamp": "2026-01-14T06:00:00.000Z",
  "checks": {
    "database": { "status": "ok", "latencyMs": 45 },
    "redis": { "status": "ok", "latencyMs": 12 },
    "gemini": { "status": "ok", "latencyMs": 230 }
  },
  "totalLatencyMs": 287,
  "summary": "db:ok, redis:ok, gemini:ok"
}

# Response (503 Service Unavailable - Not Ready):
{
  "status": "not_ready",
  "checks": {
    "database": {
      "status": "error",
      "latencyMs": 5001,
      "message": "Database check timeout"
    },
    "redis": { "status": "ok", "latencyMs": 15 }
  }
}