---
title: "Create Network"
method: POST
path: "/api/v1/network/private-networks"
tags: ["network"]
---

# Create Network

`POST /api/v1/network/private-networks`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/v1/network/private-networks`
- Auth: HTTP bearer

Creates a network.

## Request body

- PrivateNetworkCreate
  - `name` string, required

## Response `201`

Successful Response

- PrivateNetworkOut
  - `id` string, required
  - `name` string, required
  - `createdAt` string, date-time, required
  - `cutOff` boolean, required
  - `status` 'connected' | 'waiting_for_approval' | 'not_connected', required
  - `statusDetail` string, nullable, required
  - `allowsInternet` boolean, required
  - `connectors` ConnectorOut[], required
    - `id` string, required
    - `hostname` string, required
    - `connected` boolean, required
    - `lastSeenAt` string, date-time, nullable, required
    - `allow` string[], required
    - `allowsInternet` boolean, required
  - `resources` ResourceOut[], required
    - `id` string, required
    - `networkId` string, required
    - `name` string, required
    - `target` string, required
    - `address` string, required
    - `approved` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/maritime/apis/maritime-api.md) - [All operations](https://skmtc.dev/maritime/apis/maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maritime/apis/maritime-api/revisions/acd712090ad6?raw)