Skip to main content
POST
/
v1
/
memories
Error
A valid request URL is required to generate request examples
{
  "memory_id": "<string>",
  "scope": "<string>",
  "content": "<string>",
  "category": "<string>",
  "importance": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-API-Key
string
header
required

Personal Access Token, sent verbatim as pat_<32 chars>. PATs are minted from the Chief settings UI.

Headers

​
X-Project-Id
string
required

Project identifier scoping the request. Required on every project-scoped public endpoint. Missing or malformed values respond with HTTP 400 and code publicapi.tenancy.project.missing.

Pattern: ^project_[a-z0-9]{20}$

Body

application/json

Store a memory. category is one of identity, preference, fact, context, or instruction. importance is a caller-assigned ranking weight.

​
content
string
required
​
category
enum<string>
required
Available options:
identity,
preference,
fact,
context,
instruction
​
importance
integer
required
​
scope
string

Optional. Only an empty value or project is supported for now.

Response

Memory created.

Full memory view. Tenancy, audit, and lifecycle internals are omitted.

​
memory_id
string
required
Pattern: ^memory_[a-z0-9]{20}$
​
scope
string
required
​
content
string
required
​
category
string
required
​
importance
integer
required
​
created_at
string<date-time>
required
​
modified_at
string<date-time>
required