Documentation

POST

api

Error

A valid request URL is required to generate request examples

{
  "query": "<string>",
  "candidates": [
    {
      "memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "content": "<string>",
      "memory_type": "<string>",
      "score": 123,
      "created_at": "<string>",
      "event_time": "<string>",
      "owner_name": "<string>",
      "source": "<string>"
    }
  ]
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

Authorizations

Authorization

string

header

required

JWT access token or API key (csk_...)

Body

application/json

query

string

required

The search query text

Required string length: 1 - 3000

space_id

string<uuid>

required

The memory space to search within

limit

integer

default:10

Max number of results to return

Required range: 1 <= x <= 50

recency_bias

number | null

Override recency weighting. 0.0 disables recency, higher values favor recent memories.

Required range: 0 <= x <= 1

rerank

boolean

default:true

Apply cross-encoder reranking. Disable for lower latency.

graph

boolean

default:true

Include graph traversal signal. Disable for semantic + keyword only.

diversify

boolean

default:false

Apply MMR diversity post-rerank. Enable for broad/summarization intents.

include_source

boolean

default:true

Include original source text in results.

Response

Ranked memory candidates

query

string

required

candidates

object[]

required

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "query": "<string>",
  "candidates": [
    {
      "memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "content": "<string>",
      "memory_type": "<string>",
      "score": 123,
      "created_at": "<string>",
      "event_time": "<string>",
      "owner_name": "<string>",
      "source": "<string>"
    }
  ]
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

{
  "detail": null
}

auth

oauth-consumer

organizations

visibility

spaces

sources

memories

entities

graph

search

conversations

jobs

usage

billing

webhooks

oauth-server

Search Memories

Authorizations

Body

Response