Skip to main content
POST
/
v1
/
memories
/
search
Search memories
curl --request POST \
  --url https://api.thrindex.com/v1/memories/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "How often does the user want emails?",
  "agent_id": "support-agent",
  "user_id": "user-42",
  "k": 10,
  "task_context": "Composing a notification preferences summary"
}
'
{
  "results": [
    {
      "id": "<string>",
      "content": "<string>",
      "agent_id": "<string>",
      "user_id": "<string>",
      "level": 123,
      "status": "<string>",
      "importance": 123,
      "confidence": 123,
      "score": 123,
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "latency_ms": 123,
  "cache_hit": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.thrindex.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns 200 with ranked results. Scope: memory:read.

Authorizations

Authorization
string
header
required

API key (mk_live_...) from the Thrindex dashboard.

Body

application/json
query
string
required
Maximum string length: 2048
agent_id
string
required
user_id
string
required
k
integer
default:10
Required range: 1 <= x <= 100
task_context
string

Optional context to improve ranking for the current task.

level
enum<integer>

Filter by memory level. Omit to search all levels.

Available options:
0,
1,
2

Response

Ranked results

results
object[]
latency_ms
integer
cache_hit
boolean