---
title: "Update a group's network associations"
method: PUT
path: "/groups/{groupId}/networks"
tags: ["Group"]
---

# Update a group's network associations

`PUT /groups/{groupId}/networks`

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.

## Path parameters

- `groupId` string, required

## Headers

- `tenant-id` string

## Request body

- UpdateGroupNetworksRequest — Request to update a group's network associations
  - `networks` UpdateGroupNetworkRequest[], required — List of networks to associate with this group
    - `networkId` string, required — ID of the network
    - `networkData` object — Network association data (status, terminationDate, effectiveDate, participationType, etc.)

## Response `200`

Successfully updated group network associations

- GroupNetworkUpdateResponse — Response containing updated group-network associations
  - `tenantGroupId` string — ID of the tenant group
  - `networkAssociations` NetworkAssociationResult[] — List of updated network associations
    - `networkId` string — ID of the network
    - `tenantGroupNetworkId` string — ID of the tenant group network association
    - `status` string — Indicates if this was a new association or an update

## Other responses

- `400` — Bad request - Invalid input or validation error
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Group or network not found
- `409` — Active network association already exists
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)