FruxonDocs
Agent NetworkGraph

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.

POST
/v1/tenants/{tenant}/networks/{network}/participants

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
tenant*string

The tenant identifier

Request Body

The participant to grant plus relationship and per-customer policy.

participantId?string

The Fruxon.Model.Participants.Participant to grant access to (a Person or Group).

Formatuuid
relationshipKey?string

In what capacity the participant may interact — served customer (default), observer, or advisor.

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

§17.8 per-customer agent switch: ON answers normally, OFF_HUMAN_ONLY disables the agent for this participant while leaving the human path untouched. Defaults ON.

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

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/participants" \  -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
}

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.

Renames an Application, or changes its slug.

Updates the Application's operator-facing display name and/or its slug. Applies immediately and everywhere the name is rendered — the name is never copied into other rows. A rename leaves the slug alone: the slug is what every shared link is built from, so it changes only when the request names it, and doing so breaks links built on the old one. A slug already in use in the tenant is a 409. Ownership of the Agents and Workflows the Application holds is immutable and cannot be changed here. The Default Application can be renamed: it is the default because of its flag, not because of its name.