FruxonDocs
Agent NetworkGraph

Installs or partially updates a Network capability's live enablement and configuration.

Installs a capability that has no row yet, or partially updates a backfilled one — omitted fields stay unchanged. Use it to toggle live enablement and/or replace configuration; an unknown capability type yields `400 Bad Request`. Applies immediately, without publishing a new Network revision.

PATCH
/v1/tenants/{tenant}/networks/{network}/capabilities/{capability}

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

The capability type.

Value in"UNSPECIFIED" | "SUPPORT_CASES" | "HUMAN_ESCALATION"
tenant*string

The tenant identifier

Request Body

Enablement/configuration changes; omitted fields stay unchanged.

enabled?boolean|null

When present, enables or disables the capability for the Network.

configuration?

The live Fruxon.Model.AgentNetwork.NetworkCapabilityInstance.Configuration payload (design §6) — a small typed bag the capability-owning service interprets per Fruxon.Model.AgentNetwork.NetworkCapabilityType. Kept as one jsonb object so a new capability adds a property rather than a column. V1 only needs the Support-Cases profile; human escalation's pool lives in Fruxon.Model.AgentNetwork.NetworkEscalationPolicy, so its slot stays empty until acceptance windows land.

clearConfiguration?boolean

When true, clears Fruxon.Model.AgentNetwork.UpdateNetworkCapabilityRequest.Configuration. Takes precedence over no value and cannot be combined with a replacement configuration.

[key: string]?never

Response Body

curl -X PATCH "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/capabilities/UNSPECIFIED" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "capabilityType": "SUPPORT_CASES",
  "enabled": false,
  "configuration": {
    "supportCases": {
      "creationMode": "string"
    }
  },
  "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
}

Lists the live capability instances materialized for a Network.

Returns the operational capabilities materialized for the Network (for example SUPPORT_CASES), each badged with its live enablement and configuration. The supported capability set is small and fixed, so it is returned as a single page. Changes here apply immediately, without publishing a new Network revision.

Lists the Network's Support Cases, most-recently-modified first.

Returns every `support.case` WorkItem owned by the Network, each carrying its live status (`OPEN` / `WITH_OPERATOR` / `RESOLVED` / `CLOSED`), external key, lifecycle policy, requester participant, and primary topic (for deep-linking into the conversation). Returned as one page. 404 when the Network does not exist; an empty list when the Network has no Cases.