SmartMemory
PUT
/memory/agents/{agent_id}/recall-profile

Set an agent's recall profile for personality-aware retrieval.

Profile shape: {"memory_type_weights": {"decision": 2.0, "procedural": 1.5, "episodic": 0.5}} Empty dict clears the profile (restores default behavior).

Path Parameters

agent_id*Agent Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request model for updating agent recall profile.

Response Body

application/json

application/json

curl -X PUT "https://example.com/memory/agents/string/recall-profile" \  -H "Content-Type: application/json" \  -d '{    "recall_profile": {}  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Search Memory

Search for memory items using semantic and contextual matching. Optionally use SSG (Similarity Graph Traversal) for better multi-hop reasoning. Set use_ssg=true to enable SSG, or leave as null to use config default. Requires authentication and operates on user-scoped data. SecureSmartMemory handles tenant isolation automatically via ScopeProvider.

Set Retrieval Policy

Replace overrides; only the workspace owner or tenant admin may mutate.