v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB

Memories

Fetch a single memory by caller-owned metadata.externalId.

Reverse lookup of a memory by its metadata.externalId, scoped to user_id. the caller stamps its own id into metadata.externalId on quick-ingest; this resolves that id back to the core memory. Returns the same body as GET /v1/memories/{id}.

get/v1/memories/by-external-id/{externalId}

Path parameters

externalIdstring required

Query parameters

user_idstring required

Response

Memory object.

access_countnumber required

agent_idstring nullable

contentstring required

created_atstring required

deleted_atstring nullable

embeddingnumber[] required

episode_idstring nullable

expired_atstring nullable

idstring required

importancenumber required

keywordsstring required

last_accessed_atstring required

memory_typestring required

metadataobject required

namespacestring nullable

{"stackTrail":"paths:/v1/memories/by-external-id/{externalId}:get:responses:200:content:application/json:schema:properties:network","oasType":"schema","type":"unknown"}

observation_subjectstring nullable

observed_atstring required

opinion_confidencenumber nullable

overviewstring required

source_sitestring required

source_urlstring required

status'active' | 'needs_clarification' required

summarystring required

trust_scorenumber required

user_idstring required

visibility'agent_only' | 'restricted' | 'workspace' | 'null' nullable

workspace_idstring nullable