Create a link between two memory items.
Requires authentication and validates memory ownership with tenant isolation.
Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to create a link between memory items.
Response Body
application/json
application/json
curl -X POST "https://example.com/memory/link" \ -H "Content-Type: application/json" \ -d '{}'null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Link Decision Evidence
Link a stored evidence node to a live decision (SM-EVIDENCE-TYPE-1). Confidence is unchanged. 404 when the decision or the evidence is absent (another workspace's evidence included), 409 when the decision is superseded or retracted, 422 when either id names a node of another memory_type. A second link adds nothing.
Linking Stage
Run linking pipeline stage. Links and deduplicates entities across the knowledge graph. Requires authentication and operates on user-scoped data. Requires storage stage to be completed first.