Sign in
Documents

Search documents

Search memories with advanced filtering

post/v3/search

Request body

chunkThresholdnumber

Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most chunks, more results), 1 is most sensitive (returns lesser chunks, accurate results)

containerTagstring

Optional single container tag. Use this or containerTags.

containerTagsstring[]

Optional tags this search should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter documents.

docIdstring

Optional document ID to search within. You can use this to find chunks in a very large document.

documentThresholdnumber

DEPRECATED: This field is no longer used in v3 search. The search now uses chunkThreshold only. This parameter will be ignored.

includeFullDocsboolean

If true, include full document in the response. This is helpful if you want a chatbot to know the full context of the document.

includeSummaryboolean

If true, include document summary in the response. This is helpful if you want a chatbot to know the full context of the document.

limitinteger

Maximum number of results to return

onlyMatchingChunksboolean

If true, only return matching chunks without context. Normally, we send the previous and next chunk to provide more context for LLMs. If you only want the matching chunk, set this to true.

qstring required

Search query string

rerankboolean

If true, rerank the results based on the query. This is helpful if you want to ensure the most relevant results are returned.

rewriteQueryboolean

If true, rewrites the query to make it easier to find documents. This increases the latency by about 400ms

categoriesFilterstring[]

DEPRECATED: Optional category filters

filepathstring

Filter search results by filepath. Exact match for full paths, prefix match if ending with /

Example request

{
  "chunkThreshold": 0.5,
  "containerTag": "user_alex",
  "limit": 10,
  "q": "what are the API rate limits"
}

Response

Search results

timingnumber required
totalnumber required

Example response

{
  "results": [
    {
      "chunks": [
        {
          "content": "Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.",
          "isRelevant": true,
          "position": 3,
          "score": 0.85
        }
      ],
      "createdAt": "1970-01-01T00:00:00.000Z",
      "documentId": "doc_xyz789",
      "metadata": {
        "source": "upload",
        "language": "en"
      },
      "score": 0.95,
      "summary": "API rate limit policy: 100 req/min free, 1000 req/min pro.",
      "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
      "title": "API Rate Limiting Policy",
      "updatedAt": "1970-01-01T00:00:00.000Z",
      "type": "web"
    }
  ]
}

Changes