[ Web Proxy ]
URL:
Viewing: https://docs.digitalocean.com/reference/paperspace/api-reference/private-networks/ [Back]  [Original]
Private Networks | DigitalOcean Documentation

For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Private Networks

Generated on 18 Aug 2026

Copy page as Markdown View page as Markdown
Base URL https://api.paperspace.com/v1

Endpoints

GET Get a private network PUT Update a private network DELETE Delete a private network GET List private networks POST Create a private network

GET Get a private network

/private-networks/{id}
Authorizations: BearerAuth
Http: Bearer

An API key or access token

Fetches a single private network by ID.

Path Parameters

id string required

The ID of the private network to fetch.

Request: /private-networks/{id}
cURL 
curl -X GET \
  -H "Authorization: Bearer $API_TOKEN" \
  "https://api.paperspace.com/v1/private-networks/{id}"

Responses

200

Successful response
Response Schema: application/json
dtCreated string (date-time) required

The date the private network was created.

dtDeleted string optional Nullable

The date the private network was deleted.

id string required

The ID of the private network.

name string required

The name of the private network.

netmask string required

The subnet mask of the private network.

network string required

The network prefix of the private network.

region string, one of: ny2, ca1, ams1 required

The region the private network is in.

default

Error response
Response Schema: application/json
code string required
details object optional
message string required
Response
200 
{
  "dtCreated": "2019-08-24T14:15:22Z",
  "id": "string",
  "name": "string",
  "netmask": "string",
  "network": "string",
  "region": "ny2"
}
default 
{
  "code": "string",
  "message": "string"
}

PUT Update a private network

/private-networks/{id}
Authorizations: BearerAuth
Http: Bearer

An API key or access token

Updates a single private network by ID.

Path Parameters

id string required

The ID of the private network to update.

Request Body: application/json

name string optional

The name of the private network.

Request: /private-networks/{id}
Payload
Content type application/json 
{
  "name": "string"
}
cURL 
curl -X PUT \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}' \
  "https://api.paperspace.com/v1/private-networks/{id}"

Responses

200

Successful response
Response Schema: application/json
dtCreated string (date-time) required

The date the private network was created.

dtDeleted string optional Nullable

The date the private network was deleted.

id string required

The ID of the private network.

name string required

The name of the private network.

netmask string required

The subnet mask of the private network.

network string required

The network prefix of the private network.

region string, one of: ny2, ca1, ams1 required

The region the private network is in.

default

Error response
Response Schema: application/json
code string required
details object optional
message string required
Response
200 
{
  "dtCreated": "2019-08-24T14:15:22Z",
  "id": "string",
  "name": "string",
  "netmask": "string",
  "network": "string",
  "region": "ny2"
}
default 
{
  "code": "string",
  "message": "string"
}

DELETE Delete a private network

/private-networks/{id}
Authorizations: BearerAuth
Http: Bearer

An API key or access token

Deletes a single private network by ID.

Path Parameters

id string required

The ID of the private network to delete.

Request: /private-networks/{id}
cURL 
curl -X DELETE \
  -H "Authorization: Bearer $API_TOKEN" \
  "https://api.paperspace.com/v1/private-networks/{id}"

Responses

200

Successful response
Response Schema: application/json
id string required

The ID of the private network to delete.

default

Error response
Response Schema: application/json
code string required
details object optional
message string required
Response
200 
{
  "id": "string"
}
default 
{
  "code": "string",
  "message": "string"
}

GET List private networks

/private-networks
Authorizations: BearerAuth
Http: Bearer

An API key or access token

Fetches a list of private networks.

Query Parameters

after string optional

Fetch the next page of results after this cursor.

limit integer 1 120 optional

The number of items to fetch after this page.

orderBy string, one of: dtCreated, name optional

Order results by one of these fields.

Default: dtCreated
order string, one of: asc, desc optional

The order to sort the results by.

Default: desc
name string optional
region anyOf optional
Request: /private-networks
cURL 
curl -X GET \
  -H "Authorization: Bearer $API_TOKEN" \
  "https://api.paperspace.com/v1/private-networks"

Responses

200

Successful response
Response Schema: application/json
hasMore boolean required

Whether there are more pages of results available.

items array of object required

The items on this page.

Show child properties
dtCreated string (date-time) required

The date the private network was created.

dtDeleted string optional Nullable

The date the private network was deleted.

id string required

The ID of the private network.

name string required

The name of the private network.

netmask string required

The subnet mask of the private network.

network string required

The network prefix of the private network.

region string, one of: ny2, ca1, ams1 required

The region the private network is in.

nextPage string optional

The cursor required to fetch the next page of results. i.e. ?after=nextPage. This is null when there is no next page.

default

Error response
Response Schema: application/json
code string required
details object optional
message string required
Response
200 
{
  "hasMore": true,
  "items": [
    {
      "dtCreated": "2019-08-24T14:15:22Z",
      "id": "string",
      "name": "string",
      "netmask": "string",
      "network": "string",
      "region": "ny2"
    }
  ],
  "nextPage": "string"
}
default 
{
  "code": "string",
  "message": "string"
}

POST Create a private network

/private-networks
Authorizations: BearerAuth
Http: Bearer

An API key or access token

Creates a new private network.

Request Body: application/json

migrateMachines boolean optional

Whether to migrate all machines not currently in a private network to the new private network.

name string required

The name of the private network.

region string, one of: ny2, ca1, ams1 required

The region the private network is in.

Request: /private-networks
Payload
Content type application/json 
{
  "migrateMachines": false,
  "name": "string",
  "region": "ny2"
}
cURL 
curl -X POST \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "migrateMachines": false,
  "name": "string",
  "region": "ny2"
}' \
  "https://api.paperspace.com/v1/private-networks"

Responses

200

Successful response
Response Schema: application/json
dtCreated string (date-time) required

The date the private network was created.

dtDeleted string optional Nullable

The date the private network was deleted.

id string required

The ID of the private network.

name string required

The name of the private network.

netmask string required

The subnet mask of the private network.

network string required

The network prefix of the private network.

region string, one of: ny2, ca1, ams1 required

The region the private network is in.

default

Error response
Response Schema: application/json
code string required
details object optional
message string required
Response
200 
{
  "dtCreated": "2019-08-24T14:15:22Z",
  "id": "string",
  "name": "string",
  "netmask": "string",
  "network": "string",
  "region": "ny2"
}
default 
{
  "code": "string",
  "message": "string"
}

In this article...

Private Networks

We can't find any results for your search.

Try using different keywords or simplifying your search terms.

Web Proxy Viewer  |  New URL  |  Original Page