Skip to main content
POST
/
v1
/
memories
Create memories
curl --request POST \
  --url https://pnbr.io/v1/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>",
  "subject": {},
  "source_context": "<string>",
  "forget_after": "2023-11-07T05:31:56Z",
  "forget_reason": "<string>",
  "shape_id": "<string>",
  "project_id": "<string>",
  "apply": true,
  "memories": [
    {}
  ]
}
'
{
  "id": "<string>",
  "project_id": "<string>",
  "delta_id": "<string>",
  "applied": true,
  "request_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

A pnbr- API key. Project-scoped keys make project_id implicit; org-scoped keys require it.

Body

application/json
​
content
string
required

The memory text (required).

​
kind
enum<string>
Available options:
preference,
decision,
fact,
lesson,
observation,
signal
​
scope
enum<string>
Available options:
agent,
commons,
project
​
subject
object
​
source_context
string
​
forget_after
string<date-time>

Time-bound memory: recallable until this timestamp.

​
forget_reason
string
​
shape_id
string
​
project_id
string
​
apply
boolean
default:true
​
memories
object[]

Batch form (1-100). Omit for a single memory.

Response

Applied

Returned by governed writes. status is applied (committed) or staged (apply:false). Descend via delta_id.

​
id
string | null
​
status
enum<string>
Available options:
applied,
staged,
failed
​
project_id
string
​
delta_id
string
​
applied
boolean
​
request_id
string