Skip to content
Navigation

Set a memory node's visibility

Mark one entity node public or private.

Nodes are private until this is called — extraction never sets visibility, so nothing becomes public by inference. Marking a node public does not share it: it keeps its group and is still served to its owner alone. Cross-user sharing is what shared namespaces (graph_id) are for.

The agent_id path segment is accepted for URL symmetry with the other /memories/{agent_id}/... routes but does not narrow the scope — the node is matched across the caller's agents, because the memory browser that lists nodes is itself cross-agent. Another user's node is never reachable.

Responses: 404 when the node isn't in the requested scope; 422 MEMORY_NODE_PROTECTED for structural nodes (the user's own User node, Topic and Value taxonomy nodes) — the same set DELETE .../nodes/{id} refuses. Marking the User node public would make every fact hanging off it satisfy a visibility=public query at once.

PATCH
https://truememory-api.mvstg.com/memories/{agent_id}/nodes/{node_id}/visibility
View as Markdown

Authorization

  • HTTPBearerHTTPrequired

Path parameters

  • agent_idstringrequired
  • node_idstringrequired

Header parameters

  • X-On-Behalf-Ofoptional

    One of the following:

    • string
    • null
  • X-External-User-Idoptional

    One of the following:

    • string
    • null
  • X-App-Idoptional

    One of the following:

    • string
    • null

Request bodyJSONrequired

  • visibilityprivateorpublicrequired

    'public' un-privates the node; 'private' puts it back.

  • graph_idoptional

    Optional. Target a node in a shared namespace instead of the user's own memory. Requires a service token; the agent_id path segment is ignored.

    One of the following:

    • string
    • null

Returns

200

Successful Response

JSON
  • idstringrequired
  • namerequired

    One of the following:

    • string
    • null
  • labelsarray ofstringrequired
  • group_idrequired

    One of the following:

    • string
    • null
  • visibilityprivateorpublicrequired

422

Validation Error
JSON
  • detailoptionalarray ofobject
    • locarray ofrequired

      One of the following:

      • string
      • integer
    • msgstringrequired
    • typestringrequired
    • inputoptionalunknown
    • ctxoptionalobject

Type to search…

↑↓ navigate↵ selectEsc close