Sign in

v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB
Memories

Ingest a conversation transcript with full extraction.

Full-extraction ingest. The metadata field on the body schema is rejected with 400 on this route — caller metadata is only supported on POST /v1/memories/ingest/quick with skip_extraction=true and no workspace context.

post/v1/memories/ingest

Request body

agent_idstring

Optional agent identifier. Silently dropped if empty / non-string.

config_overrideobject

Optional per-request overlay on RuntimeConfig. Keys correspond to RuntimeConfig field names; values must be primitives (boolean / number / string / null). Unknown keys are accepted but surfaced via the X-Atomicmem-Unknown-Override-Keys response header and a server-side warning log — they do not cause a 400. Scope: just this request — no server mutation.

content_class'summary' | 'redacted' | 'raw'

Optional sensitivity class of the supplied content: 'summary' (distilled, hosted-safe), 'redacted' (sensitive spans removed by the caller), or 'raw' (verbatim prompt/response/diff/source). When the deployment runs RAW_CONTENT_POLICY=reject, a verbatim write of 'raw' content — or content with no content_class at all (treated as unknown/raw) — is rejected with 422 raw_content_rejected; on extraction paths the raw transcript is instead withheld from the stored audit episode.

conversationstring required

Required. conversation.

metadataobject

Caller-supplied metadata, persisted alongside the memory. Honored ONLY on /v1/memories/ingest/quick with skip_extraction=true and no workspace context — rejected with 400 on every other branch. Reserved keys (RESERVED_METADATA_KEYS in repository-types) are rejected. Max 32 KB UTF-8 serialized.

session_idstring

Optional thread/session identifier used to scope ingest, search, and list symmetrically.

skip_extractionboolean
source_sitestring required

Required. source_site.

source_urlstring
user_idstring required

Required. user_id.

visibility'agent_only' | 'restricted' | 'workspace'

Visibility (one of agent_only / restricted / workspace). Invalid values silently drop to undefined.

workspace_idstring

Optional workspace identifier. Silently dropped if empty / non-string.

Response

Ingest result with extracted facts.

composites_creatednumber required
episode_idstring required
facts_extractednumber required
ingest_trace_idstring
links_creatednumber required
memories_deletednumber required
memories_skippednumber required
memories_storednumber required
memories_updatednumber required
stored_memory_idsstring[] required
updated_memory_idsstring[] required