VEvectorize
Memory

Get memory graph data

Changed on

Retrieve graph data for visualization, optionally filtered by type (world/experience/observation).

get/v1/default/banks/{bank_id}/graph

Request

Path parameters

bank_idstring required

Query parameters

typestring nullable
limitinteger
qstring nullable

Case-insensitive substring filter on memory text and context. Not indexed: it scans the bank, so it slows as the bank grows. Meant for browsing and inspection, not for high-volume or latency-sensitive workloads — use recall for that.

tagsstring[] nullable
tags_match'any' | 'all' | 'any_strict' | 'all_strict' | 'exact'
document_idstring nullable
chunk_idstring nullable

Headers

authorizationstring nullable

Response

Successful Response

total_unitsinteger required
limitinteger required

Example response

{
  "edges": [
    {
      "data": {
        "id": "1-2-semantic",
        "linkType": "semantic",
        "source": "1",
        "target": "2",
        "weight": 0.8
      }
    }
  ],
  "limit": 1000,
  "nodes": [
    {
      "data": {
        "id": "1",
        "label": "Alice works at Google",
        "text": "Alice works at Google"
      }
    },
    {
      "data": {
        "id": "2",
        "label": "Bob went hiking",
        "text": "Bob went hiking"
      }
    }
  ],
  "table_rows": [
    {
      "context": "Work info",
      "date": "2024-01-15 10:30",
      "entities": "Alice (PERSON), Google (ORGANIZATION)",
      "id": "abc12345...",
      "text": "Alice works at Google"
    }
  ],
  "total_units": 2
}

Changes

  • 45e711cd0897Revision changes
    • breaking

      the query request parameter tags_match was restricted to a list of enum values

    • info

      added the new enum value all to the query request parameter tags_match

    • info

      added the new enum value all_strict to the query request parameter tags_match

    • info

      added the new enum value any to the query request parameter tags_match

    • info

      added the new enum value any_strict to the query request parameter tags_match

    • info

      added the new enum value exact to the query request parameter tags_match

  • 4fda98b75f63Revision changes
    • warning

      for the query request parameter limit, the min was set to 0.00

    • warning

      removed the optional property // from the response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status