Skip to main content
POST
Execute a read-only Cypher query

Body

application/json

Request body for POST /v1/memory/cypher.

query
string
required

Read-only Cypher query (MATCH / WHERE / RETURN). Write keywords (CREATE, MERGE, DELETE, SET, REMOVE, DROP, FOREACH, LOAD, CALL) are rejected for safety.

Required string length: 1 - 10000
limit
integer
default:500

Maximum number of nodes to return.

Required range: 1 <= x <= 5000

Response

Successful Response

Response for GET /graph (the full tenant graph, v2 contract).

nodes
MemoryGraphNode · object[]
required
edges
MemoryGraphEdge · object[]
required
truncated
boolean
default:false

True when the result was capped by the limit parameter. The frontend can use this to show 'displaying N of total_nodes'.

total_nodes
integer | null

Actual node count before the cap was applied. Only populated when truncated=True.