Skip to main content
Multi-relational memory connects memory fragments within a session using typed edges (semantic / temporal / causal / entity) and supports bounded graph retrieval. These edges live in the cloud; the SDK local backend uses aria memo’s separate relation plane (SQLite) and does not merge it into the cloud graph. All endpoints require Authorization: Bearer <api_key> (optional if AGENT_CLOUD_API_KEY is unset).

Create a relation edge

Endpoint

Path parameters

string
required
Session identifier.

Request body

string
required
Source fragment id.
string
required
Target fragment id.
string
required
Relation kind, e.g. causal, semantic, temporal.
number
Edge weight, default 0.8.
string
Provenance tag, default rest.

Response

string
Session identifier.
string
Source fragment id.
string
Target fragment id.
string
Relation kind.
number
Edge weight.
string
Provenance tag.
integer
Epoch milliseconds.

List relation edges

Endpoint

Query parameters

string
Filter by relation kind.
string
Filter by source fragment id.
string
Filter by target fragment id.
integer
Max results, default 50, clamped to 1–200.

Response

Standard list envelope (object, data, has_more), where data is an array of RelationItem.

Delete relation edges

Endpoint

Query parameters

string
Filter by relation kind.
string
Filter by source fragment id.
string
Filter by target fragment id.
Provide at least one of from, to, kind, otherwise a 400 is returned.

Response

string
Always relation.deleted.
string
Session identifier.
integer
Number of edges deleted.

Graph retrieval

Endpoint

Query parameters

string
required
Comma-separated seed fragment ids, at least one.
string
Comma-separated relation kinds that limit the traversal view.
integer
Traversal budget, default 60.
integer
Maximum hops, default 3.
integer
Max edges returned, default 20.

Response

Returns a GraphRetrieveResponse with nodes and edges arrays describing the bounded subgraph rooted at the seeds.