API: all pages
Docs homeOverviewAPITools & MCPBasicsSavingReading and contextAgent runsWebhooks and connectorsRetries and idempotencyErrors and limitsCreditsPrivacy and deletionConsole sign-inAPI / Use it / SavingCopy this page for your AI (Markdown)
Saving
| Route | What it does | Main fields |
|---|---|---|
POST /v1/memories |
Saves one memory | user, text; optional: source, thread, acl (readers), at (when it was said), expires_at, url + title + anchor (a web clip), partial, timezone, viewer |
POST /v1/events |
Saves typed events (status changes, assignments) exactly | user, events: [{type, object, to, actor, time}] |
POST /v1/imports |
Imports many records as a job | user, records: [...] (or a supported export format); returns a job_id |
GET /v1/jobs/{id} |
Shows a job’s progress | — |
POST /v1/feedback |
Corrects or confirms a memory | user, target, kind (wrong, outdated, pin, unpin, verify, same_person, different_people), note |
POST /v1/notes |
Saves a note your model wrote. A note is never used as evidence | user, text |
- Unknown fields are refused with a
400that lists the allowed ones. - A save answers
status:indexed: searchable now;queued: accepted in order and searchable shortly. Passmin_versionon a read to wait for it.
- The same text saved twice is one record.