FruxonDocs
Agent NetworkGraph

Partially updates a served-participant grant's relationship, status, and/or §17.8 policy.

Set the status to `REVOKED` to withdraw access (soft — the row and its audit survive), retag the relationship, or flip the per-customer agent-mode policy. Omitted fields stay unchanged; no field may carry the UNSPECIFIED sentinel. Applies immediately.

PATCH
/v1/tenants/{tenant}/networks/{network}/participants/{participant}

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 owning Network id.

Formatuuid
participant*string

The participant id.

Formatuuid
tenant*string

The tenant identifier

Request Body

The relationship / status / policy changes.

relationshipKey?string

When present, retags the relationship (SERVED / OBSERVER / ADVISOR). UNSPECIFIED is rejected.

Value in"UNSPECIFIED" | "SERVED" | "OBSERVER" | "ADVISOR"
status?string

When present, sets the grant lifecycle (ACTIVE or REVOKED). UNSPECIFIED is rejected.

Value in"UNSPECIFIED" | "ACTIVE" | "REVOKED" | "REMOVED"
agentMode?string

When present, flips the §17.8 per-customer agent switch (ON / OFF_HUMAN_ONLY). UNSPECIFIED is rejected.

Value in"UNSPECIFIED" | "ON" | "OFF_HUMAN_ONLY"
[key: string]?never

Response Body

curl -X PATCH "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/participants/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "participantId": "00000000-0000-0000-0000-000000000000",
  "relationshipKey": "SERVED",
  "status": "ACTIVE",
  "source": "MANUAL",
  "agentMode": "ON",
  "escalationOverride": {
    "tiers": [
      {
        "operatorParticipantIds": [],
        "strategy": "UNSPECIFIED"
      }
    ],
    "mode": "PREFERRED",
    "allOperatorParticipantIds": []
  },
  "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
}

Sets (full replace) the participant's dedicated-operator escalation override.

The participant must already be a served participant of the Network (a customer is granted access before they get dedicated operators) — otherwise `404 Not Found`. Every operator must be an active operator of the Network (enroll them via the operators directory first); an unknown or non-operator participant yields `400 Bad Request`. Resolved ahead of the network pool at escalation time. Applies immediately. Returns the updated served-participant row, whose `escalationOverride` echoes the set override.

Grants a participant access to the Network.

The participant must exist and be a Person or Group; an AI agent is a member/peer and yields `400 Bad Request`. Idempotent: re-granting an existing participant re-applies its relationship and §17.8 policy and re-activates a revoked grant. Applies immediately.