FruxonDocs
Agent NetworkGraph

Updates a membership's release pin, operational status, and/or owning Network (move).

Live controls: set or clear the per-Network release pin, drain/disable the membership, and/or re-home it to another Network (its id stays stable so conversations and WorkItems stay bound). Applies immediately.

PATCH
/v1/tenants/{tenant}/networks/{network}/memberships/{membership}

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

network*string

The Network id the membership currently belongs to.

Formatuuid
membership*string

The membership id to update.

Formatuuid
tenant*string

The tenant identifier

Request Body

The pin/status changes and an optional target Network to move to.

pinnedRelease?integer|null

When present, sets the release pin. Send an explicit null via Fruxon.Model.AgentNetwork.UpdateNetworkMembershipRequest.ClearPinnedRelease to un-pin (float back to the agent's current release); omitting both leaves the pin unchanged.

Formatint64
clearPinnedRelease?boolean

When true, clears the pin (float to current). Takes precedence over Fruxon.Model.AgentNetwork.UpdateNetworkMembershipRequest.PinnedRelease.

operationalStatus?string

Live operational status of an Fruxon.Model.AgentNetwork.AgentNetworkMembership (design §4.3, §8.2). A safety control an operator can flip without a deployment: it may narrow or disable a member, but the live-override rule is that it can never enable behaviour absent from the network's live configuration.

Value in"UNSPECIFIED" | "ACTIVE" | "DRAINING" | "DISABLED" | "REMOVED"
targetNetworkId?string|null

When present, re-homes the membership to this network (I6 move), keeping its id stable so conversations and WorkItems stay bound. Must exist in the tenant and not already contain the agent.

Formatuuid
[key: string]?never

Response Body

curl -X PATCH "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/memberships/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "agentId": "string",
  "operationalStatus": "ACTIVE",
  "pinnedRelease": 0,
  "createdAt": 0,
  "modifiedAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Removes an agent from a Network.

Soft-removes the membership: the agent drops off the Network's roster and can no longer route, govern, or run there, but the row is retained so its conversations, runs, and audit history stay bound. Re-adding the agent reactivates the same membership. Applies immediately.

Assigns an agent to a Network as a stable member, optionally pinning its release.

Adds the agent as a conversational member of the Network; a non-Agent-shaped agent is rejected once the member-eligibility invariant is enforced (M0). Optionally pins the member's release for this Network. Applies immediately.