---
title: "Update an existing network"
method: PUT
path: "/networks/{id}"
tags: ["Network"]
---

# Update an existing network

`PUT /networks/{id}`

Replaces the network record identified by `id` for the tenant identified by the `tenant-id` header. The request body's `data` object is validated against the same Network JSON schema used on create; currently the only recognized field is `name` (optional). The network must already exist. Requires the `UPDATE_NETWORK` permission. On success, returns the updated network with HTTP 201.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string, required

## Request body

- CreateNetworkRequest
  - `data` NetworkSchema — Represents collection of health care providers associated with a plan through a contract.
    - `name` string — The name of the network.
    - `contractId` string — The identifier of the associated contract.

## Response `200`

Retained for backward documentation compatibility; this operation currently always returns 201 on success (see the 201 response below).

- NetworkResponse
  - `data` object
    - `id` string, uuid
    - `name` string
    - `contractId` string

## Other responses

- `201` — Network updated successfully
- `400` — Bad Request
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `500` — Internal server error

## Changes

- **2026-08-19** `563848e0ecc0` — 1 breaking, 23 warning, 2 info
  - the `errorDetails` response's property type/format changed from `array`/`` to `object`/`` for status `400`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `errorDetails/array` from the response with the `400` status
  - removed the optional property `errorDetails/bigDecimal` from the response with the `400` status
  - …22 more

[Change history](https://skmtc.dev/certifyos/apis/certify-api-layer/changes/networks/:id/put.md)

---

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