Sign in
Docs
API referenceMemories

API reference

Search memories

Have a token? Manage tokens in the console
GET
/v1/memory/records/search

Memories ranked by meaning (embedding similarity), then memories kept without an embedding whose text or topics hold every word of the query; active ones first. Memories of a space you cannot read are never returned.

Needs scope decisions:read.

Authorization

bearer
headerAuthorizationBearer <JWT>

An access token from the identity provider: a person's, or a customer's from the client credentials grant with an API key (developers.inorbit.hr). The gateway verifies it; the audience is iohr-api.

Query Parameters

account_id?string

A team you belong to; empty for your own account.

query?string

What to look for, in plain words.

kind?string

decision, preference, fact, question, handoff or done.

space_id?string

The account-wide memories and this space's.

include_inactive?boolean

Superseded and resolved memories too.

page_size?integer

At most this many; 0 means 20, above 100 means 100.

Formatint32

Response Body

iohr.memory.v1.SearchRecordsResponse

application/json
  1. response

iohr.memory.v1.SearchRecordsResponse

fallback*boolean
records*array<>
stub*boolean
threshold*number
Formatfloat
import { ApiError, Public } from "@inorbithr/sdk";// Reads INORBIT_TOKEN, or INORBIT_KEY_ID and INORBIT_KEY_SECRET.const api = Public.fromEnv();try {  const { value } = await api.memory.searchRecords();  console.log(value);} catch (e) {  if (!(e instanceof ApiError)) throw e;  console.error(`${e.code}: ${e.problem} (request id ${e.raw.requestId})`);  process.exitCode = 1;}

npm install @inorbithr/sdk. Calls the package's public surface; an operation newer than your package needs the next release or a client generated for your account. The SDKs.

Example Response
{  "fallback": true,  "records": [    {      "account_id": "string",      "agent": "string",      "decided_by": "string",      "kind": "string",      "links": [        "string"      ],      "record_id": "string",      "recorded_at": "string",      "recorded_by": "string",      "redactions": 0,      "score": 0.1,      "seen": 0,      "seen_at": "string",      "session": "string",      "space_id": "string",      "status": "string",      "summary_id": "string",      "superseded_by": "string",      "text": "string",      "topics": [        "string"      ],      "via": "string"    }  ],  "stub": true,  "threshold": 0.1}