Create a memory
POST/v1/projects/:project_id/memories
Writes a fact to the specified memory store through the standard write algorithm: the content is embedded (or matched to text the store already holds), compared against the most similar currently-valid memory, and resolved to exactly one of three outcomes — skipped at or above duplicate_threshold, superseded at or above supersede_threshold, created below it. supersedes overrides that comparison entirely, retiring the memory it names. Every call records one assertion, whatever the outcome.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 500
The write resolved against an existing memory — action is skipped (the fact was already known) or superseded (the fact had changed, and the returned memory is the replacement).
Memory created
Bad request — a missing required field, a threshold pair whose effective values are not supersede_threshold < duplicate_threshold, or a supersedes that is not a memory id, or names a memory in another memory store or one already superseded.
Unauthorized
Forbidden — the caller may not write to the memory store, or may not update the memory named by supersedes.
Memory store not found, or no memory matches supersedes
The project's storage_bytes quota is exceeded (QUOTA_STORAGE_EXCEEDED). Delete stored content, or raise the quota — no window reset clears a stored total, so no Retry-After is sent.
Internal server error