---
title: "Report memory vector index health and retrieval mode"
method: GET
path: "/api/memory/health"
tags: ["Memory"]
---

# Report memory vector index health and retrieval mode

`GET /api/memory/health`

## Response `200`

Memory vector index health

- object
  - `sqliteVec` object, required
    - `extensionLoaded` boolean, required
    - `tableExists` boolean, required
    - `initialized` boolean, required
    - `vectorDimensions` number, required
    - `distanceMetric` 'cosine', required
    - `schema` string, nullable, required
    - `lastPopulate` object, nullable, required
      - `attempted` number, required
      - `inserted` number, required
      - `skippedInvalidDimensions` number, required
      - `failed` number, required
      - `beforeCount` number, required
      - `afterCount` number, required
  - `counts` object, required
    - `total` number, required
    - `withEmbedding` number, required
    - `validEmbedding` number, required
    - `invalidEmbedding` number, required
    - `searchable` number, required
    - `memoryVec` number, required
    - `missingFromVec` number, required
    - `extraInVec` number, required
  - `retrievalMode` 'vec' | 'fallback', required
  - `reasons` string[], required

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/0375890be8c4/schema)