Skip to content
LogoLogo

Memory

Nebula memory SDK operations.

GET /v2/collections/{collection_id}/memories

GET/v2/collections/{collection_id}/memories

Public Nebula SDK contract for memory.list.

Path Parameters

collection_idRequired
string·min 1·max 128

Query Parameters

cursor
string·min 1·max 2048

Opaque keyset cursor. Pass back the next_cursor from the previous response; cursors are signed and cannot be constructed. A cursor is bound to the operation and path that issued it and expires 15 minutes after issue; using it elsewhere or later returns invalid_request. Changing limit between pages is safe.

limit
integer·min 1·max 200·default 50

Maximum items to return in one page.

Responses

POST /v2/collections/{collection_id}/memories

POST/v2/collections/{collection_id}/memories

Public Nebula SDK contract for memory.store.

Path Parameters

collection_idRequired
string·min 1·max 128

Request Body

application/json
contentRequired
memory_idRequired
string <uuid>
metadata
object

Responses

GET /v2/collections/{collection_id}/memories/{memory_id}

GET/v2/collections/{collection_id}/memories/{memory_id}

Public Nebula SDK contract for memory.get.

Path Parameters

collection_idRequired
string·min 1·max 128
memory_idRequired
string·min 1·max 128

Query Parameters

include
string
Values
content

Responses

DELETE /v2/collections/{collection_id}/memories/{memory_id}

DELETE/v2/collections/{collection_id}/memories/{memory_id}

Public Nebula SDK contract for memory.delete.

Path Parameters

collection_idRequired
string·min 1·max 128
memory_idRequired
string·min 1·max 128

Responses

POST /v2/collections/{collection_id}/memories/search

POST/v2/collections/{collection_id}/memories/search

Public Nebula SDK contract for memory.search.

Path Parameters

collection_idRequired
string·min 1·max 128

Request Body

application/json
effort
string·default auto

Bounded retrieval work, not a result count. Auto resolves to low.

Values
autolowmediumhigh
entity_id
string <uuid>

Start from a returned grounded entity identity instead of global discovery. Query still controls local relevance. Unknown or unavailable identities return an empty anchored result without global fallback.

include_sources
boolean·default false

Return full evidence detail for selected results. Compact provenance is the default.

minimum_confidence
number·min 0·max 1·default 0.1
queryRequired
string·min 1·max 8192
retrieval_idRequired
string <uuid>
tables_only
boolean·default false

Discover distinct published table occurrences before ranking. Cannot be combined with entity_id. Mixed search remains the default.

valid_at
string <date-time>

Evaluate fact validity at this RFC 3339 instant with an explicit timezone and millisecond precision or coarser. Defaults to now; does not select an old storage snapshot.

Responses