> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodepick.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# VPC Networks API

> Manage isolated Virtual Private Cloud (VPC) networks and subnets.

The VPC Networks API allows creating and managing private isolated subnets for compute nodes.

## Endpoints

| Method | Endpoint | Description |
| - | - | - |
| `POST` | `/api/v1/networking` | Create a new VPC network |
| `GET` | `/api/v1/networking` | List all VPC networks |
| `GET` | `/api/v1/networking/{id}` | Get configuration details of a VPC |
| `DELETE` | `/api/v1/networking/{id}` | Delete a VPC network |

***

### Create a VPC (`POST /api/v1/networking`)

```bash theme={null}
curl -X POST https://api.nodepick.ai/api/v1/networking \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production-vpc",
    "region": "fmt1",
    "description": "Primary backend VPC"
  }'
```

#### Request Body

| Field | Type | Required | Description |
| - | - | - | - |
| `name` | string | Yes | Unique name for the VPC network |
| `region` | string | No | Target region (e.g. `fmt1`, `us-west-1`) |
| `description` | string | No | Optional human-readable description |

***

### List VPCs (`GET /api/v1/networking`)

```bash theme={null}
curl -X GET https://api.nodepick.ai/api/v1/networking \
  -H "Authorization: Bearer YOUR_API_KEY"
```

***

### Delete a VPC (`DELETE /api/v1/networking/{id}`)

```bash theme={null}
curl -X DELETE https://api.nodepick.ai/api/v1/networking/a90f1e84-180b-4866-9aa2-947ca793a39e \
  -H "Authorization: Bearer YOUR_API_KEY"
```

A VPC cannot be deleted while active compute nodes remain assigned to it.

***

## Python SDK

```python theme={null}
from nodepick import NodePickClient

client = NodePickClient(api_key="YOUR_API_KEY")

# Create
vpc = client.vpc_create(name="prod-vpc", region="fmt1")

# List
vpcs = client.vpc_list()

# Get
details = client.vpc_get(vpc["id"])

# Delete
client.vpc_delete(vpc["id"])
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.