FruxonDocs
Agent NetworkGraph

Binds an existing tenant integration connection to a Network.

The request references a connection id only; credentials remain tenant-owned.

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

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 receiving the connection grant.

Formatuuid
tenant*string

The tenant identifier

Request Body

The tenant connection id and Network-local grant settings.

integrationConnectionId?string

The tenant Fruxon.Model.AgentNetwork.IntegrationConnection to grant this Network.

Formatuuid
alias?string|null

Optional operator-facing name for the connection within this Network.

allowedActions?|null

Least-privilege action ids. An empty list means every action supported by the connection.

providerEnvironment?string|null

Optional provider environment selector; null inherits the connection default.

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/integrationBindings" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "integrationConnectionId": "00000000-0000-0000-0000-000000000000",
  "alias": "string",
  "allowedActions": [
    "string"
  ],
  "providerEnvironment": "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
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Updates the grant alias, action allowlist, environment, and/or live emergency status.

Applies immediately to this Network grant. Set an empty allowed-actions list for unrestricted use, use explicit clear flags for nullable labels, or set DISABLED for an emergency stop. Credentials are never accepted or changed here.

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.