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
Request body
Relation kind, e.g. causal, semantic, temporal.
Edge weight, default 0.8.
Provenance tag, default rest.
Response
List relation edges
Endpoint
Query parameters
Filter by source fragment id.
Filter by target fragment id.
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
Filter by source fragment id.
Filter by target fragment id.
Provide at least one of from, to, kind, otherwise a 400 is returned.
Response
Graph retrieval
Endpoint
Query parameters
Comma-separated seed fragment ids, at least one.
Comma-separated relation kinds that limit the traversal view.
Traversal budget, default 60.
Max edges returned, default 20.
Response
Returns a GraphRetrieveResponse with nodes and edges arrays describing the bounded subgraph rooted at the seeds.