Memory

Create a peer and name its observers

Human users only. Creating a peer decides which agents may read a model of a person, and an agent that could do that could add itself.

Idempotent on (org, peer_type, peer_ref). Observers are merged, not replaced — a second call adding one agent does not revoke the others already watching. Every named observer must be an agent in this organisation, so a typo or an id copied from elsewhere is an error rather than a silent no-op that leaves an operator believing an agent is watching when none is.

post/v1/peers

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/peers
  • Auth: HTTP bearer

Request body

peer_type'user' | 'platform_connection' | 'external' required
peer_refstring required
display_namestring
platform_connection_idstring uuid
observer_agent_idsstring[]

Empty means nobody. A peer with no observers is readable by no agent.

Response

Peer created or updated

Changes

No recorded changes to this operation across all 1 revision of this API.