Search a Memory Store

curl --request POST \
  --url https://api.checkfu.com/v1/memory-stores/{id}/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '
{
  "query": "<string>",
  "revision": "<string>",
  "path_prefix": "<string>",
  "limit": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://api.checkfu.com/v1/memory-stores/{id}/search"

payload = {
    "query": "<string>",
    "revision": "<string>",
    "path_prefix": "<string>",
    "limit": 50,
    "cursor": "<string>"
}
headers = {
    "checkfu-version": "<checkfu-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'checkfu-version': '<checkfu-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: '<string>',
    revision: '<string>',
    path_prefix: '<string>',
    limit: 50,
    cursor: '<string>'
  })
};

fetch('https://api.checkfu.com/v1/memory-stores/{id}/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.checkfu.com/v1/memory-stores/{id}/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'revision' => '<string>',
    'path_prefix' => '<string>',
    'limit' => 50,
    'cursor' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "checkfu-version: <checkfu-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/v1/memory-stores/{id}/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("checkfu-version", "<checkfu-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.checkfu.com/v1/memory-stores/{id}/search")
  .header("checkfu-version", "<checkfu-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/v1/memory-stores/{id}/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["checkfu-version"] = '<checkfu-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "revision": "<string>",
  "results": [
    {
      "store": "<string>",
      "revision": "<string>",
      "path": "<string>",
      "content_sha256": "<string>",
      "snippet": "<string>",
      "score": 123,
      "provenance": {
        "source_event_ids": [
          "<string>"
        ],
        "source_revision_ids": [
          "<string>"
        ],
        "source_refs": [
          "<string>"
        ],
        "confidence": "observed",
        "valid_from": "<string>",
        "curation_run": "<string>",
        "supersedes": {
          "path": "<string>",
          "revision": "<string>"
        }
      }
    }
  ],
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "validation.malformed",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-malformed"
  }
}

{
  "error": {
    "type": "auth.invalid_key",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-invalid-key"
  }
}

{
  "error": {
    "type": "auth.disabled_tenancy",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-disabled-tenancy"
  }
}

{
  "error": {
    "type": "memory.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#memory-not-found"
  }
}

{
  "error": {
    "type": "budget.exceeded",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#budget-exceeded"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

{
  "error": {
    "type": "memory.backend_unavailable",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#memory-backend-unavailable"
  }
}

Search a Memory Store

Lexical, deterministic, revision-pinned retrieval over one store. Omitting revision resolves canonical once and searches that exact revision rather than a moving ref; narrow with path_prefix, bound with limit (1–100), and continue with cursor. Results carry path, content digest, snippet, score, and structured provenance alongside the resolved revision, and never reveal documents the caller may not read. This mutates nothing despite being a POST.

Checkfu support posture: preview; rollout_fenced. Required evidence journey: memory-stores. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

POST

memory-stores

{id}

Search a Memory Store

curl --request POST \
  --url https://api.checkfu.com/v1/memory-stores/{id}/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '
{
  "query": "<string>",
  "revision": "<string>",
  "path_prefix": "<string>",
  "limit": 50,
  "cursor": "<string>"
}
'

import requests

url = "https://api.checkfu.com/v1/memory-stores/{id}/search"

payload = {
    "query": "<string>",
    "revision": "<string>",
    "path_prefix": "<string>",
    "limit": 50,
    "cursor": "<string>"
}
headers = {
    "checkfu-version": "<checkfu-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'checkfu-version': '<checkfu-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: '<string>',
    revision: '<string>',
    path_prefix: '<string>',
    limit: 50,
    cursor: '<string>'
  })
};

fetch('https://api.checkfu.com/v1/memory-stores/{id}/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.checkfu.com/v1/memory-stores/{id}/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'revision' => '<string>',
    'path_prefix' => '<string>',
    'limit' => 50,
    'cursor' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "checkfu-version: <checkfu-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/v1/memory-stores/{id}/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("checkfu-version", "<checkfu-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.checkfu.com/v1/memory-stores/{id}/search")
  .header("checkfu-version", "<checkfu-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/v1/memory-stores/{id}/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["checkfu-version"] = '<checkfu-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"revision\": \"<string>\",\n  \"path_prefix\": \"<string>\",\n  \"limit\": 50,\n  \"cursor\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "revision": "<string>",
  "results": [
    {
      "store": "<string>",
      "revision": "<string>",
      "path": "<string>",
      "content_sha256": "<string>",
      "snippet": "<string>",
      "score": 123,
      "provenance": {
        "source_event_ids": [
          "<string>"
        ],
        "source_revision_ids": [
          "<string>"
        ],
        "source_refs": [
          "<string>"
        ],
        "confidence": "observed",
        "valid_from": "<string>",
        "curation_run": "<string>",
        "supersedes": {
          "path": "<string>",
          "revision": "<string>"
        }
      }
    }
  ],
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "validation.malformed",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-malformed"
  }
}

{
  "error": {
    "type": "auth.invalid_key",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-invalid-key"
  }
}

{
  "error": {
    "type": "auth.disabled_tenancy",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-disabled-tenancy"
  }
}

{
  "error": {
    "type": "memory.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#memory-not-found"
  }
}

{
  "error": {
    "type": "budget.exceeded",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#budget-exceeded"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

{
  "error": {
    "type": "memory.backend_unavailable",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#memory-backend-unavailable"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version

enum<string>

required

Available options:

2026-08-27

Path Parameters

string

required

Pattern: ^memstore_[0-9a-f]{32}$

Body

application/json

query

string

required

Required string length: 1 - 500

revision

string

Pattern: ^mrev_[0-9a-f]{32}$

path_prefix

string

Required string length: 1 - 1024

limit

integer

Required range: 1 <= x <= 100

cursor

string

Maximum string length: 64

Response

Success

revision

string

required

Pattern: ^mrev_[0-9a-f]{32}$

results

object[]

required

Show child attributes

next_cursor

string | null

required

Developer tools

Canonical tables

Author protocols

Generated HTTP API

Search a Memory Store

Authorizations

Headers

Path Parameters

Body

Response