DocsRecall
context for your prompt, ask for an answer in words, search for ranked memories. This page is generated from the API's own spec, so it says exactly what the API does.
The memories that bear on a question, written out for your prompt
POST/v1/context
Put context straight into your prompt. It is the same ten lines of formatting every
integration writes after calling search, so we write them once. When nothing is held it says so
in words rather than coming back empty, because an empty block reads to a model as permission.
| Parameter | In | Type | Description |
|---|---|---|---|
X-Geniffy-Space |
header | string | One of your own users, for every call this client makes. (up to 128 characters) |
Body (application/json)
| Field | Type | Description | |
|---|---|---|---|
question |
string | required | What your model is about to answer (at least 1 character; up to 2,000 characters) |
limit |
integer | optional | (at least 1; at most 50; default 12) |
kind |
all, people, plan, pref, detail |
optional | |
with_sources |
boolean | optional | Put where each memory came from beside it (default true) |
space |
string | optional | One of your own users. Leave it out for your own memory. (up to 128 characters) |
Returns 200
| Field | Type | Description | |
|---|---|---|---|
question |
string | required | |
context |
string | required | Put this straight into your prompt. Never empty: when nothing is held it says so, so your model does not fill the silence. |
memories |
array of Memory | required | |
used |
integer | required | |
empty |
boolean | required | true when nothing stored bears on the question |
Answer from the memory only, or say nothing supports it
POST/v1/ask
| Parameter | In | Type | Description |
|---|---|---|---|
X-Geniffy-Space |
header | string | One of your own users, for every call this client makes. (up to 128 characters) |
Body (application/json)
| Field | Type | Description | |
|---|---|---|---|
question |
string | required | (at least 1 character; up to 2,000 characters) |
space |
string | optional | One of your own users. Leave it out for your own memory. (up to 128 characters) |
Returns 200
| Field | Type | Description | |
|---|---|---|---|
question |
string | required | |
answer |
string | optional | None when nothing in the memory supports an answer |
message |
string | optional | |
memories |
array of Memory | required | |
clash |
boolean | optional | (default false) |
The memories that best match a query
POST/v1/search
| Parameter | In | Type | Description |
|---|---|---|---|
X-Geniffy-Space |
header | string | One of your own users, for every call this client makes. (up to 128 characters) |
Body (application/json)
| Field | Type | Description | |
|---|---|---|---|
q |
string | required | (at least 1 character; up to 2,000 characters) |
limit |
integer | optional | (at least 1; at most 50; default 10) |
kind |
all, people, plan, pref, detail |
optional | |
space |
string | optional | One of your own users. Leave it out for your own memory. (up to 128 characters) |
Returns 200
| Field | Type | Description | |
|---|---|---|---|
memories |
array of Memory | required | |
counts |
object | required | |
total |
integer | required | |
next |
integer | optional |
Last updated October 5, 2026