---
title: "Query agent memory"
method: POST
path: "/api/orgs/{org}/agents/memory/query"
tags: ["Agents"]
---

# Query agent memory

`POST /api/orgs/{org}/agents/memory/query`

Queries the agent memory graph or grep index. Supports graph traversal,
grep-style pattern matching, and semantic search strategies.

## Path parameters

- `org` string, required

## Request body

- MemoryQueryInput
  - `query` string, required — Natural language or pattern query
  - `strategy` 'graph' | 'grep' | 'semantic' | 'auto' — Query strategy to use
  - `topK` integer — Maximum number of results to return
  - `context` object — Additional context for the query
    - `organizationRef` string
    - `repository` string
    - `namespace` string

## Response `200`

Memory query results

- MemoryQueryResult
  - `results` object[]
    - `id` string
    - `score` number
    - `content` string
    - `metadata` object
  - `total` integer
  - `strategy` string

## Other responses

- `400` — Bad request — invalid input or malformed JSON
- `500` — Internal server error

---

[API](https://skmtc.dev/a5c-ai/apis/kradle-api.md) · [All operations](https://skmtc.dev/a5c-ai/apis/kradle-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/a5c-ai/kradle-api/revisions/b5eadb2ecd8b/schema)