kythene.v1.KytheneService

Recall

Recall returns memories with their full content in one call, newest first, filtered by project/tags/search.

post/kythene.v1.KytheneService/Recall

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/Recall
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

projectstring

project narrows recall to this project's memory; empty = space-wide.

tagsstring[]

tags narrows recall to memories carrying all of these tags.

searchstring

search matches memory titles.

limitinteger

default 20, max 100

typestring

type optionally narrows recall to memories of this classifier (case-insensitive); empty returns memories of any type. See RememberRequest.type for the suggested set.

includeDeprecatedboolean

include_deprecated also returns memories that have been deprecated (flagged via MemoryEntry.deprecated). Default false: deprecated memories are hidden so instances stop applying them.

scopestring

scope selects the corpus: "everything" (the default) recalls team/project memory AND published, non-memory collections you can access; "memory" narrows to memory only. Each result's kind says which it is.

cursorstring

cursor pages through a result set larger than one limit. Pass the next_cursor from a previous recall to get the following page; omit it for the first page. Use it to read a whole project to completeness rather than trusting a single capped call - a silent cap makes an agent treat what it did not fetch as absent.

spacestring

space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

Response

Success

guidestring

guide is the workspace's operating manual (house rules), returned inline so an instance picks up the space's conventions at session start without a second call - the equivalent of auto-loading a project's house style. Follow it when writing memories and collections here. See GetWorkspaceGuide.

totalinteger

total is how many memories match this query in full, before the per-page limit. If total is greater than the number of memories returned, you have NOT seen everything - page with next_cursor. Do not conclude a memory is absent from a single capped page.

appliedLimitinteger

applied_limit is the page size actually used after clamping (the requested limit is capped at 100 per call).

nextCursorstring

next_cursor is set when more pages remain; pass it back as request.cursor to fetch the next page. Empty means this page reached the end.

Example response

{
  "memories": [
    {
      "artifacts": [
        {
          "createdAt": "2023-01-15T01:30:15.01Z",
          "updatedAt": "2023-01-15T01:30:15.01Z"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.