Skip to main content
POST
/
v1
/
sdk
/
remember
Capture a Memory with provenance.
curl --request POST \
  --url https://api.reload.chat/v1/sdk/remember \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>",
  "scope_id": "<string>",
  "derived_from": [
    {
      "id": "<string>"
    }
  ],
  "confidence": 1,
  "ttl_seconds": 123,
  "stated_by_identity_id": "<string>",
  "where": "<string>",
  "why": "<string>",
  "metadata": {}
}
'
{
  "data": {
    "id": "<string>",
    "org_id": "<string>",
    "content": "<string>",
    "confidence": 123,
    "version": 123,
    "ttl_seconds": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "last_reinforced_at": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z",
    "invalidated_at": "2023-11-07T05:31:56Z",
    "invalidated_by": "<string>",
    "invalidated_reason": "<string>",
    "content_hash": "<string>",
    "metadata": {}
  },
  "meta": {
    "requestId": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "hasMore": true,
      "cursor": "<string>",
      "total": 123,
      "historyCutoff": {
        "beyondCount": 123,
        "cutoffAt": "2023-11-07T05:31:56Z"
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
content
string
required
​
kind
enum<string>
required

Memory node kind (locked V1 vocabulary).

Available options:
decision,
fact,
preference
​
scope_id
string
required
​
derived_from
object[]
required
Minimum array length: 1
​
confidence
number
default:1
Required range: 0 <= x <= 1
​
ttl_seconds
integer

Raw TTL. Provide this OR ttl_preset, not both.

​
ttl_preset
enum<string>

Named TTL bucket: 7d / 90d / 365d.

Available options:
VOLATILE,
ACTIVE,
STABLE
​
stated_by_identity_id
string
​
where
string

5W "Where" — origin context the claim was made in.

​
why
string

5W "Why" — reason the claim was captured.

​
metadata
object

Free-form JSON metadata. Capped at 4KB serialized (server rejects oversize).

Response

Success

​
success
enum<boolean>
required
Available options:
true
​
data
object
required
​
meta
object