FruxonDocs
Agent NetworkGraph

Creates a new, non-default Network.

Creates an operator-facing Network (never the Default). The new Network starts empty; Agents and Workflows select it when they are created. Applies immediately. A slug is derived from the name unless the request supplies one. A supplied slug is used exactly as given — it is the link the caller is choosing — so one already in use in the tenant is a 409 rather than a quietly suffixed alternative. Archived Applications still hold their slugs.

POST
/v1/tenants/{tenant}/networks
AuthorizationBearer <token>

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

In: header

Path Parameters

tenant*string

The tenant identifier

name?string

Operator-facing display name (e.g. "Customer Support", "Finance Operations").

slug?string|null

Optional URL-safe identifier for the Application's deep links (e.g. customer-support). Derived from Fruxon.Model.AgentNetwork.CreateNetworkRequest.Name when omitted, with -2/-3/… appended if that is already taken. Supplied explicitly it must already be canonical — lowercase alphanumerics and single inner hyphens — and free, or the request is rejected rather than silently given a different slug.

acknowledgeRefusedSenders?boolean|null

When present, whether a sender this Application refuses is told their message is being looked at rather than met with silence (Fruxon.Model.AgentNetwork.Network.AcknowledgeRefusedSenders). Off unless set: an auto-reply to every unrecognized inbound is a spam and cost surface on a public channel.

unknownSenderAdmission?string

When present, what this Application does with a sender no directory identity matches. Fruxon.Model.AgentNetwork.InboundAdmissionPolicy.RequestAccess queues them for a human; Fruxon.Model.AgentNetwork.InboundAdmissionPolicy.Reject ignores them entirely — no run, no queue entry, and nothing retained.

Value in"UNSPECIFIED" | "REQUEST_ACCESS" | "REJECT" | "PROVISION"
knownUnenrolledAdmission?string

When present, the same choice for a known contact holding no grant here. Separate from Fruxon.Model.AgentNetwork.CreateNetworkRequest.UnknownSenderAdmission because they are different decisions.

Value in"UNSPECIFIED" | "REQUEST_ACCESS" | "REJECT" | "PROVISION"
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/networks" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "string",
  "slug": "string",
  "isDefault": false,
  "acknowledgeRefusedSenders": false,
  "unknownSenderAdmission": "REQUEST_ACCESS",
  "knownUnenrolledAdmission": "REQUEST_ACCESS",
  "createdAt": 0,
  "modifiedAt": 0,
  "members": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "networkId": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "operationalStatus": "ACTIVE",
      "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
}