Create an IP block
Since 7.1.0Create an IPv4 or IPv6 block. name and type are enough; any field the update accepts can be sent too, so one call can create a configured, enabled block.
Try it
Sent from this browser to your panel with your token. Changes live data.
⌘↵Request
Authorization
Authorization header when making requests to protected resources.Example:
Authorization: Bearer ********************Body Paramsapplication/json#
The block. Uses the same field names and nesting as the block GET returns.
Whether the block hands out addresses. An enabled IPv4 block needs a netmask; an enabled IPv6 block needs ipv6.subnet, ipv6.from and ipv6.to.
1 when servers get their addresses by DHCP, 0 when they are configured statically. true and false are also accepted.
The network profile the block belongs to; 0 is any.
How reverse DNS is handled for the block's addresses. The words none, automatic and zone are also accepted on write.
| Value | Meaning |
|---|---|
0 | None |
1 | Automatic |
2 | From the reverse DNS zone in rdnsZoneId, which is then required |
The reverse DNS zone when rdnsType is 2; cleared otherwise.
IPv6 blocks only. The route block whose networks are routed to the block's subnets, or null for none. Cannot change while subnets of this block are mapped into the current route block.
With a change to ipv6.subnet, ipv6.from or ipv6.to, confirms that the generated subnets may be deleted. Not stored.
IPv4 blocks only.
IPv6 blocks only. The block is configured when subnet is set; from and to must then be set as well (a new block carries 48 and 64 until changed). Setting subnet to null clears the configuration.
fields
Any address inside the source prefix; stored as the prefix's first address. Null means the block is not configured.
Prefix length of the source prefix. 48 on a new block.
Prefix length of the subnets handed to servers; longer than from. 64 on a new block.
4 for an IPv4 block, 6 for an IPv6 block. Fixed once created.
{
"name": "Public 192.168.10.0/24",
"type": 4
}{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}Request Code Samples
curl --location --request POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
--header 'Authorization: Bearer <token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Public 192.168.10.0/24",
"type": 4
}'wget --quiet --output-document=- \
--method=POST \
--header='Authorization: Bearer <token>' \
--header='Accept: application/json' \
--header='Content-Type: application/json' \
--body-data='{
"name": "Public 192.168.10.0/24",
"type": 4
}' \
'https://cp.domain.com/api/v1/connectivity/ipblocks'http POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
'Authorization: Bearer <token>' \
'Accept: application/json' \
'Content-Type: application/json' <<< '{
"name": "Public 192.168.10.0/24",
"type": 4
}'const response = await fetch("https://cp.domain.com/api/v1/connectivity/ipblocks", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({
"name": "Public 192.168.10.0/24",
"type": 4
}),
});
const data = await response.json();
console.log(response.status, data);import axios from "axios";
const response = await axios({
method: "post",
url: "https://cp.domain.com/api/v1/connectivity/ipblocks",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
data: {
"name": "Public 192.168.10.0/24",
"type": 4
},
});
console.log(response.status, response.data);const https = require("https");
const payload = JSON.stringify({
"name": "Public 192.168.10.0/24",
"type": 4
});
const req = https.request({
hostname: "cp.domain.com",
path: "/api/v1/connectivity/ipblocks",
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
"Content-Length": Buffer.byteLength(payload),
},
}, (res) => {
let data = "";
res.on("data", (chunk) => (data += chunk));
res.on("end", () => console.log(res.statusCode, JSON.parse(data)));
});
req.on("error", (err) => console.error(err));
req.write(payload);
req.end();import requests
url = "https://cp.domain.com/api/v1/connectivity/ipblocks"
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = {
"name": "Public 192.168.10.0/24",
"type": 4,
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.status_code)
print(response.json())import http.client
import json
conn = http.client.HTTPSConnection("cp.domain.com")
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = json.dumps({
"name": "Public 192.168.10.0/24",
"type": 4,
})
conn.request("POST", "/api/v1/connectivity/ipblocks", payload, headers)
response = conn.getresponse()
print(response.status)
print(json.loads(response.read()))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://cp.domain.com/api/v1/connectivity/ipblocks',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Public 192.168.10.0/24',
'type' => 4,
]),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer <token>',
'Accept: application/json',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('POST', 'https://cp.domain.com/api/v1/connectivity/ipblocks', [
'headers' => [
'Authorization' => 'Bearer <token>',
'Accept' => 'application/json',
],
'json' => [
'name' => 'Public 192.168.10.0/24',
'type' => 4,
],
]);
echo $response->getStatusCode() . "\n";
echo $response->getBody();package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
url := "https://cp.domain.com/api/v1/connectivity/ipblocks"
payload := strings.NewReader(`{
"name": "Public 192.168.10.0/24",
"type": 4
}`)
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Accept", "application/json")
req.Header.Add("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(body))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://cp.domain.com/api/v1/connectivity/ipblocks"))
.header("Authorization", "Bearer <token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"Public 192.168.10.0/24\",\"type\":4}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
MediaType json = MediaType.get("application/json");
RequestBody body = RequestBody.create("{\"name\":\"Public 192.168.10.0/24\",\"type\":4}", json);
Request request = new Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.code());
System.out.println(response.body().string());
}
}
}using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var request = new HttpRequestMessage(new HttpMethod("POST"), "https://cp.domain.com/api/v1/connectivity/ipblocks");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<token>");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Content = new StringContent("{\"name\":\"Public 192.168.10.0/24\",\"type\":4}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "json"
uri = URI("https://cp.domain.com/api/v1/connectivity/ipblocks")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer <token>"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"Public 192.168.10.0/24\",\"type\":4}"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts JSON.pretty_generate(JSON.parse(response.body))import Foundation
var request = URLRequest(url: URL(string: "https://cp.domain.com/api/v1/connectivity/ipblocks")!)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\"name\":\"Public 192.168.10.0/24\",\"type\":4}".data(using: .utf8)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data, error == nil else { print(error ?? "request failed"); return }
print((response as! HTTPURLResponse).statusCode)
print(String(data: data, encoding: .utf8) ?? "")
}
task.resume()// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use reqwest::blocking::Client;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "Public 192.168.10.0/24",
"type": 4
}"#)
.send()?;
println!("{}", response.status());
let json: serde_json::Value = response.json()?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}// Cargo.toml: reqwest = { version = "0.12", features = ["json"] }, tokio = { version = "1", features = ["full"] }, serde_json = "1"
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "Public 192.168.10.0/24",
"type": 4
}"#)
.send()
.await?;
println!("{}", response.status());
let json: serde_json::Value = response.json().await?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
fun main() {
val client = OkHttpClient()
val body = """{
"name": "Public 192.168.10.0/24",
"type": 4
}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build()
client.newCall(request).execute().use { response ->
println(response.code)
println(response.body?.string())
}
}// pubspec.yaml: http: ^1.2.0
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final request = http.Request('POST', Uri.parse('https://cp.domain.com/api/v1/connectivity/ipblocks'));
request.headers['Authorization'] = 'Bearer <token>';
request.headers['Accept'] = 'application/json';
request.headers['Content-Type'] = 'application/json';
request.body = r'''{
"name": "Public 192.168.10.0/24",
"type": 4
}''';
final response = await http.Response.fromStream(await request.send());
print(response.statusCode);
print(const JsonEncoder.withIndent(' ').convert(jsonDecode(response.body)));
}#include <stdio.h>
#include <curl/curl.h>
int main(void) {
CURL *curl = curl_easy_init();
if (!curl) return 1;
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_URL, "https://cp.domain.com/api/v1/connectivity/ipblocks");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"name\":\"Public 192.168.10.0/24\",\"type\":4}");
CURLcode result = curl_easy_perform(curl);
if (result != CURLE_OK) fprintf(stderr, "%s\n", curl_easy_strerror(result));
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return result == CURLE_OK ? 0 : 1;
}$headers = @{
Authorization = "Bearer <token>"
Accept = "application/json"
}
$body = @'
{
"name": "Public 192.168.10.0/24",
"type": 4
}
'@
$response = Invoke-RestMethod -Uri "https://cp.domain.com/api/v1/connectivity/ipblocks" -Method POST -Headers $headers -ContentType "application/json" -Body $body
$response | ConvertTo-Json -Depth 10POST /api/v1/connectivity/ipblocks HTTP/1.1
Host: cp.domain.com
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 55
{
"name": "Public 192.168.10.0/24",
"type": 4
}curl --location --request POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
--header 'Authorization: Bearer <token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}'wget --quiet --output-document=- \
--method=POST \
--header='Authorization: Bearer <token>' \
--header='Accept: application/json' \
--header='Content-Type: application/json' \
--body-data='{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}' \
'https://cp.domain.com/api/v1/connectivity/ipblocks'http POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
'Authorization: Bearer <token>' \
'Accept: application/json' \
'Content-Type: application/json' <<< '{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}'const response = await fetch("https://cp.domain.com/api/v1/connectivity/ipblocks", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}),
});
const data = await response.json();
console.log(response.status, data);import axios from "axios";
const response = await axios({
method: "post",
url: "https://cp.domain.com/api/v1/connectivity/ipblocks",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
data: {
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
},
});
console.log(response.status, response.data);const https = require("https");
const payload = JSON.stringify({
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
});
const req = https.request({
hostname: "cp.domain.com",
path: "/api/v1/connectivity/ipblocks",
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
"Content-Length": Buffer.byteLength(payload),
},
}, (res) => {
let data = "";
res.on("data", (chunk) => (data += chunk));
res.on("end", () => console.log(res.statusCode, JSON.parse(data)));
});
req.on("error", (err) => console.error(err));
req.write(payload);
req.end();import requests
url = "https://cp.domain.com/api/v1/connectivity/ipblocks"
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = {
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": True,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8",
},
},
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.status_code)
print(response.json())import http.client
import json
conn = http.client.HTTPSConnection("cp.domain.com")
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = json.dumps({
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": True,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8",
},
},
})
conn.request("POST", "/api/v1/connectivity/ipblocks", payload, headers)
response = conn.getresponse()
print(response.status)
print(json.loads(response.read()))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://cp.domain.com/api/v1/connectivity/ipblocks',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Public 192.168.10.0/24',
'type' => 4,
'enabled' => true,
'ipv4' => [
'gateway' => '192.168.10.1',
'netmask' => '255.255.255.0',
'resolvers' => [
'primary' => '1.1.1.1',
'secondary' => '8.8.8.8',
],
],
]),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer <token>',
'Accept: application/json',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('POST', 'https://cp.domain.com/api/v1/connectivity/ipblocks', [
'headers' => [
'Authorization' => 'Bearer <token>',
'Accept' => 'application/json',
],
'json' => [
'name' => 'Public 192.168.10.0/24',
'type' => 4,
'enabled' => true,
'ipv4' => [
'gateway' => '192.168.10.1',
'netmask' => '255.255.255.0',
'resolvers' => [
'primary' => '1.1.1.1',
'secondary' => '8.8.8.8',
],
],
],
]);
echo $response->getStatusCode() . "\n";
echo $response->getBody();package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
url := "https://cp.domain.com/api/v1/connectivity/ipblocks"
payload := strings.NewReader(`{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}`)
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Accept", "application/json")
req.Header.Add("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(body))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://cp.domain.com/api/v1/connectivity/ipblocks"))
.header("Authorization", "Bearer <token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
MediaType json = MediaType.get("application/json");
RequestBody body = RequestBody.create("{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}", json);
Request request = new Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.code());
System.out.println(response.body().string());
}
}
}using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var request = new HttpRequestMessage(new HttpMethod("POST"), "https://cp.domain.com/api/v1/connectivity/ipblocks");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<token>");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Content = new StringContent("{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "json"
uri = URI("https://cp.domain.com/api/v1/connectivity/ipblocks")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer <token>"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts JSON.pretty_generate(JSON.parse(response.body))import Foundation
var request = URLRequest(url: URL(string: "https://cp.domain.com/api/v1/connectivity/ipblocks")!)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}".data(using: .utf8)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data, error == nil else { print(error ?? "request failed"); return }
print((response as! HTTPURLResponse).statusCode)
print(String(data: data, encoding: .utf8) ?? "")
}
task.resume()// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use reqwest::blocking::Client;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}"#)
.send()?;
println!("{}", response.status());
let json: serde_json::Value = response.json()?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}// Cargo.toml: reqwest = { version = "0.12", features = ["json"] }, tokio = { version = "1", features = ["full"] }, serde_json = "1"
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}"#)
.send()
.await?;
println!("{}", response.status());
let json: serde_json::Value = response.json().await?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
fun main() {
val client = OkHttpClient()
val body = """{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build()
client.newCall(request).execute().use { response ->
println(response.code)
println(response.body?.string())
}
}// pubspec.yaml: http: ^1.2.0
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final request = http.Request('POST', Uri.parse('https://cp.domain.com/api/v1/connectivity/ipblocks'));
request.headers['Authorization'] = 'Bearer <token>';
request.headers['Accept'] = 'application/json';
request.headers['Content-Type'] = 'application/json';
request.body = r'''{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}''';
final response = await http.Response.fromStream(await request.send());
print(response.statusCode);
print(const JsonEncoder.withIndent(' ').convert(jsonDecode(response.body)));
}#include <stdio.h>
#include <curl/curl.h>
int main(void) {
CURL *curl = curl_easy_init();
if (!curl) return 1;
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_URL, "https://cp.domain.com/api/v1/connectivity/ipblocks");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"name\":\"Public 192.168.10.0/24\",\"type\":4,\"enabled\":true,\"ipv4\":{\"gateway\":\"192.168.10.1\",\"netmask\":\"255.255.255.0\",\"resolvers\":{\"primary\":\"1.1.1.1\",\"secondary\":\"8.8.8.8\"}}}");
CURLcode result = curl_easy_perform(curl);
if (result != CURLE_OK) fprintf(stderr, "%s\n", curl_easy_strerror(result));
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return result == CURLE_OK ? 0 : 1;
}$headers = @{
Authorization = "Bearer <token>"
Accept = "application/json"
}
$body = @'
{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}
'@
$response = Invoke-RestMethod -Uri "https://cp.domain.com/api/v1/connectivity/ipblocks" -Method POST -Headers $headers -ContentType "application/json" -Body $body
$response | ConvertTo-Json -Depth 10POST /api/v1/connectivity/ipblocks HTTP/1.1
Host: cp.domain.com
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 270
{
"name": "Public 192.168.10.0/24",
"type": 4,
"enabled": true,
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
}
}
}curl --location --request POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
--header 'Authorization: Bearer <token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}'wget --quiet --output-document=- \
--method=POST \
--header='Authorization: Bearer <token>' \
--header='Accept: application/json' \
--header='Content-Type: application/json' \
--body-data='{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}' \
'https://cp.domain.com/api/v1/connectivity/ipblocks'http POST 'https://cp.domain.com/api/v1/connectivity/ipblocks' \
'Authorization: Bearer <token>' \
'Accept: application/json' \
'Content-Type: application/json' <<< '{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}'const response = await fetch("https://cp.domain.com/api/v1/connectivity/ipblocks", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}),
});
const data = await response.json();
console.log(response.status, data);import axios from "axios";
const response = await axios({
method: "post",
url: "https://cp.domain.com/api/v1/connectivity/ipblocks",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
},
data: {
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
},
});
console.log(response.status, response.data);const https = require("https");
const payload = JSON.stringify({
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
});
const req = https.request({
hostname: "cp.domain.com",
path: "/api/v1/connectivity/ipblocks",
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
"Content-Length": Buffer.byteLength(payload),
},
}, (res) => {
let data = "";
res.on("data", (chunk) => (data += chunk));
res.on("end", () => console.log(res.statusCode, JSON.parse(data)));
});
req.on("error", (err) => console.error(err));
req.write(payload);
req.end();import requests
url = "https://cp.domain.com/api/v1/connectivity/ipblocks"
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = {
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": True,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1",
},
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.status_code)
print(response.json())import http.client
import json
conn = http.client.HTTPSConnection("cp.domain.com")
headers = {
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Content-Type": "application/json",
}
payload = json.dumps({
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": True,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1",
},
})
conn.request("POST", "/api/v1/connectivity/ipblocks", payload, headers)
response = conn.getresponse()
print(response.status)
print(json.loads(response.read()))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://cp.domain.com/api/v1/connectivity/ipblocks',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'name' => 'v6 2001:db8:1::/48',
'type' => 6,
'enabled' => true,
'ipv6' => [
'subnet' => '2001:db8:1::',
'from' => 48,
'to' => 64,
'gateway' => '2001:db8:1::1',
],
]),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer <token>',
'Accept: application/json',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('POST', 'https://cp.domain.com/api/v1/connectivity/ipblocks', [
'headers' => [
'Authorization' => 'Bearer <token>',
'Accept' => 'application/json',
],
'json' => [
'name' => 'v6 2001:db8:1::/48',
'type' => 6,
'enabled' => true,
'ipv6' => [
'subnet' => '2001:db8:1::',
'from' => 48,
'to' => 64,
'gateway' => '2001:db8:1::1',
],
],
]);
echo $response->getStatusCode() . "\n";
echo $response->getBody();package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
url := "https://cp.domain.com/api/v1/connectivity/ipblocks"
payload := strings.NewReader(`{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}`)
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Accept", "application/json")
req.Header.Add("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(body))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://cp.domain.com/api/v1/connectivity/ipblocks"))
.header("Authorization", "Bearer <token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
MediaType json = MediaType.get("application/json");
RequestBody body = RequestBody.create("{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}", json);
Request request = new Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.code());
System.out.println(response.body().string());
}
}
}using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var request = new HttpRequestMessage(new HttpMethod("POST"), "https://cp.domain.com/api/v1/connectivity/ipblocks");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<token>");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Content = new StringContent("{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());require "net/http"
require "json"
uri = URI("https://cp.domain.com/api/v1/connectivity/ipblocks")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer <token>"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts JSON.pretty_generate(JSON.parse(response.body))import Foundation
var request = URLRequest(url: URL(string: "https://cp.domain.com/api/v1/connectivity/ipblocks")!)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}".data(using: .utf8)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data, error == nil else { print(error ?? "request failed"); return }
print((response as! HTTPURLResponse).statusCode)
print(String(data: data, encoding: .utf8) ?? "")
}
task.resume()// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use reqwest::blocking::Client;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}"#)
.send()?;
println!("{}", response.status());
let json: serde_json::Value = response.json()?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}// Cargo.toml: reqwest = { version = "0.12", features = ["json"] }, tokio = { version = "1", features = ["full"] }, serde_json = "1"
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.request(reqwest::Method::POST, "https://cp.domain.com/api/v1/connectivity/ipblocks")
.bearer_auth("<token>")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body(r#"{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}"#)
.send()
.await?;
println!("{}", response.status());
let json: serde_json::Value = response.json().await?;
println!("{}", serde_json::to_string_pretty(&json)?);
Ok(())
}import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
fun main() {
val client = OkHttpClient()
val body = """{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
.url("https://cp.domain.com/api/v1/connectivity/ipblocks")
.method("POST", body)
.addHeader("Authorization", "Bearer <token>")
.addHeader("Accept", "application/json")
.build()
client.newCall(request).execute().use { response ->
println(response.code)
println(response.body?.string())
}
}// pubspec.yaml: http: ^1.2.0
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final request = http.Request('POST', Uri.parse('https://cp.domain.com/api/v1/connectivity/ipblocks'));
request.headers['Authorization'] = 'Bearer <token>';
request.headers['Accept'] = 'application/json';
request.headers['Content-Type'] = 'application/json';
request.body = r'''{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}''';
final response = await http.Response.fromStream(await request.send());
print(response.statusCode);
print(const JsonEncoder.withIndent(' ').convert(jsonDecode(response.body)));
}#include <stdio.h>
#include <curl/curl.h>
int main(void) {
CURL *curl = curl_easy_init();
if (!curl) return 1;
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_URL, "https://cp.domain.com/api/v1/connectivity/ipblocks");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"name\":\"v6 2001:db8:1::/48\",\"type\":6,\"enabled\":true,\"ipv6\":{\"subnet\":\"2001:db8:1::\",\"from\":48,\"to\":64,\"gateway\":\"2001:db8:1::1\"}}");
CURLcode result = curl_easy_perform(curl);
if (result != CURLE_OK) fprintf(stderr, "%s\n", curl_easy_strerror(result));
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return result == CURLE_OK ? 0 : 1;
}$headers = @{
Authorization = "Bearer <token>"
Accept = "application/json"
}
$body = @'
{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}
'@
$response = Invoke-RestMethod -Uri "https://cp.domain.com/api/v1/connectivity/ipblocks" -Method POST -Headers $headers -ContentType "application/json" -Body $body
$response | ConvertTo-Json -Depth 10POST /api/v1/connectivity/ipblocks HTTP/1.1
Host: cp.domain.com
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 200
{
"name": "v6 2001:db8:1::/48",
"type": 6,
"enabled": true,
"ipv6": {
"subnet": "2001:db8:1::",
"from": 48,
"to": 64,
"gateway": "2001:db8:1::1"
}
}Responses
201Created. The block as GET returns it.
#
An IPv4 or IPv6 block.
IPBlock fields
fields
How reverse DNS is handled for the block's addresses. The words none, automatic and zone are also accepted on write.
| Value | Meaning |
|---|---|
0 | None |
1 | Automatic |
2 | From the reverse DNS zone in rdnsZoneId, which is then required |
The route block's ID, or null. Documented as a string before 7.1.0; it has always been the ID.
1 when servers get their addresses by DHCP, 0 when they are configured statically.
{
"data": {
"id": 7,
"type": 4,
"name": "Public 192.168.10.0/24",
"ipv4": {
"gateway": "192.168.10.1",
"netmask": "255.255.255.0",
"resolvers": {
"primary": "1.1.1.1",
"secondary": "8.8.8.8"
},
"total": 0,
"usedTotal": 0,
"freeTotal": 0
},
"ipv6": {
"gateway": null,
"resolvers": {
"primary": null,
"secondary": null
},
"subnet": null,
"from": null,
"to": null,
"restricted": [],
"total": 0,
"generatedTotal": 0,
"usedTotal": 0,
"freeTotal": 0,
"freeGenerated": 0,
"blacklistedTotal": 0
},
"rdnsType": 0,
"rdnsZoneId": null,
"networkProfile": 0,
"routeBlock": null,
"dhcp": 1,
"enabled": true,
"created": "2026-10-06T15:02:11+00:00",
"updated": "2026-10-06T15:02:11+00:00"
}
}401The bearer token is missing, invalid, or expired. The response has no body.
#
422Validation failed or an unknown field was sent. Nothing was written.
#
{
"errors": {
"enabled": [
"an enabled IPv4 block needs a netmask"
]
}
}429Too many requests. Either the token's requests per minute are used up (see the `X-RateL…
#
Too many requests. Either the token's requests per minute are used up (see the X-RateLimit-* headers) or the calling address has failed authentication 10 times in a minute (the body then includes retry_after_seconds). Retry-After gives the seconds to wait.
Seconds to wait before retrying. Present on the failed-authentication limit only.
Seconds to wait before retrying.
The token's requests per minute (token limit only).
Requests left in the current minute (token limit only).
Unix timestamp at which the minute resets (token limit only).
{
"errors": [
"Too Many Requests"
]
}{
"errors": [
"Too many authentication attempts. Try again later."
],
"retry_after_seconds": 42
}