Search memory files

Search project memory files by path and body. Returns file references and snippets; fetch files by result ID or path for full bodies.

POST/v1/projects/{projectId}/memory/search

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

Request body

requiredapplication/json

querystringrequired

Search keywords or a memory file path to look up

min length 1

limitinteger

Maximum number of memory search results to return

max 20

Responses

200

Response for status 200

resultsobject[]required

Show properties

Array of object

idstringrequired

namestringrequired

created_atstringrequired

updated_atstringrequired

matchstringrequired

Allowed:namebody

snippetstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*

Bodyapplication/json

querystring*Search keywords or a memory file path to look uplimitintegerMaximum number of memory search results to return

Request

curl -X POST 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/memory/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "string",
  "limit": 1
}'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/memory/search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"query\": \"string\",\n  \"limit\": 1\n}"
});

import requests

response = requests.post(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/memory/search",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"query\": \"string\",\n  \"limit\": 1\n}",
)

Response

{
  "results": [
    {
      "id": "string",
      "name": "string",
      "created_at": "string",
      "updated_at": "string",
      "match": "name",
      "snippet": "string"
    }
  ]
}