One memory, in the same shape as the list. A memory this key cannot read answers exactly as one that does not exist.
Example
Against https://platform.memtro.com, with your key in MEMTRO_API_KEY.
curl https://platform.memtro.com/v1/memory/6f1c… \
-H "Authorization: Bearer $MEMTRO_API_KEY"
import os, requests
r = requests.get(
"https://platform.memtro.com/v1/memory/6f1c…",
headers={"Authorization": f"Bearer {os.environ['MEMTRO_API_KEY']}"},
)
r.raise_for_status()
print(r.json())
const res = await fetch("https://platform.memtro.com/v1/memory/6f1c…", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.MEMTRO_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
console.log(await res.json());
Authentication
An API key, as Authorization: Bearer or x-api-key. Read-only keys may call it.
- Every reply, errors included, carries
x-request-idandrequest-idheaders with the same id, startingreq-. Quote it to support. - Browsers may call it from any origin: it answers CORS preflights and allows the
Authorization,x-api-keyand Anthropic version headers.
Path parameters
idstringRequiredThe memory's id.
Response
200application/json
A memory object.
object"memory"OptionalAlways
memory.idstringOptionalThe memory's id.
contentstringOptionalThe statement, as remembered.
kindstringOptionalWhat sort of statement it is.
scopestringOptionalWho it belongs to: the organisation, a team, or one person.
sourcestringOptionalWhere it came from, such as
chat,syncorimport.systemstring or nullOptionalThe connected system it was read from, if any.
urlstring or nullOptionalA link to the record it came from, if one was kept.
confidencenumberOptionalHow sure the extractor was.
importancenumberOptionalHow much it matters, as the extractor judged it.
truststring or nullOptionalWhether it is believed outright or waiting to be confirmed.
taintstring or nullOptionalSet when it was learned from outside content.
corroborationsintegerOptionalHow many times something independent has confirmed it.
valid_fromstring or nullOptionalStart of the period the statement is about.
valid_tostring or nullOptionalEnd of that period, if it has one.
superseded_bystring or nullOptionalThe id of the memory that replaced it.
superseded_atstring or nullOptionalWhen it was replaced.
subject_entity_idstring or nullOptionalThe entity the statement is about.
entity_idsarray of stringsOptionalEvery entity it mentions.
connection_idstring or nullOptionalThe connection it was synced through.
episode_idstring or nullOptionalThe exchange or import it was learned from.
created_atstringOptionalWhen it was recorded.
Errors
In the OpenAI envelope, {"error": {"message", "type", "param", "code"}}. What each code means and what to do about it is in the error catalogue.
| Status | Code | When |
|---|---|---|
| 401 | invalid_api_key | The key is missing, malformed, revoked or expired. |
| 402 | subscription_inactive | The organisation has no active subscription. |
| 404 | not_found | No such memory, or not one this key can read. |