---
title: "Add new cluster network"
method: POST
path: "/private/network"
tags: ["internal-network"]
---

# Add new cluster network

`POST /private/network`

Add new cluster network

## Request body

- AddNetworkRequest — Payload to define a network
  - `vpc_data` VpcData, required — Information about the VPC
    - `vpc_id` string — The reference ID of the VPC in the provider cloud
    - `cloud_project` string — The account in AWS/project in GCP that this VPC belongs to.
    - `cloud_info` CloudInfo — Cloud deployment information
      - `code` 'AWS' | 'GCP', required — Which cloud the cluster is deployed in
      - `region` string, required
    - `cidr` string — A CIDR block
    - `vpc_type` 'Private' | 'Shared'
  - `subnets` SubnetData[]
    - `subnet_id` string — The subnet reference ID in the provider cloud
    - `subnet_mapping` string — The region/zone of the subnet
    - `is_primary` boolean — If the subnet is used for the primary NIC
  - `platform_id` string, uuid — The platform with which this VPC is peered

## Response `200`

Network response

- object
  - `data` NetworkDataResponse — Information about cluster network
    - `vpc` VpcDataResponse — Information about the VPC
      - `id` string, uuid — The ID of the VPC
      - `vpc_data` VpcData — Information about the VPC
        - `vpc_id` string — The reference ID of the VPC in the provider cloud
        - `cloud_project` string — The account in AWS/project in GCP that this VPC belongs to.
        - `cloud_info` CloudInfo — Cloud deployment information
          - `code` 'AWS' | 'GCP', required — Which cloud the cluster is deployed in
          - `region` string, required
        - `cidr` string — A CIDR block
        - `vpc_type` 'Private' | 'Shared'
      - `num_clusters` integer
    - `subnets` SubnetDataResponse[]
      - `id` string, uuid — The ID of the subnet
      - `subnet_data` SubnetData — Information about the Subnet
        - `subnet_id` string — The subnet reference ID in the provider cloud
        - `subnet_mapping` string — The region/zone of the subnet
        - `is_primary` boolean — If the subnet is used for the primary NIC

## Other responses

- `400` — API Error
- `500` — API Error

## Changes

- **2022-06-13** `7856cb3301b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yugabyte/apis/yugabyte-cloud/changes/private/network/post.md)

---

[API](https://skmtc.dev/yugabyte/apis/yugabyte-cloud.md) · [All operations](https://skmtc.dev/yugabyte/apis/yugabyte-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yugabyte/yugabyte-cloud/revisions/7856cb3301b2/schema)