latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Group

Update a group's network associations

Associates a group with one or more networks, creating new network memberships for bulk ingestion workflows where network data arrives from an external roster or source system. Not idempotent — if an active network association between this group and a requested network already exists, the server returns 409 Conflict rather than silently succeeding; resolve or terminate the existing association first.

put/groups/{groupId}/networks

Path parameters

groupIdstring required

ID of the group (certify group ID)

Headers

tenant-idstring

Request body

Example request

{
  "networks": [
    {
      "networkId": "network-123"
    }
  ]
}

Response

Successfully updated group network associations

tenantGroupIdstring

ID of the tenant group

Example response

{
  "tenantGroupId": "tg-456",
  "networkAssociations": [
    {
      "networkId": "net-123",
      "tenantGroupNetworkId": "tgn-789",
      "status": "updated"
    }
  ]
}