curl -X PATCH 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name": "Trusted office and VPN IPs"}'import os
import requests
list_uuid = '11111111-2222-3333-4444-555555555555'
resp = requests.patch(
f'https://verification.didit.me/v3/lists/{list_uuid}/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={'name': 'Trusted office and VPN IPs'},
timeout=10,
)
resp.raise_for_status()
print(resp.json())const listUuid = '11111111-2222-3333-4444-555555555555';
const resp = await fetch(`https://verification.didit.me/v3/lists/${listUuid}/`, {
method: 'PATCH',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ name: 'Trusted office and VPN IPs' }),
});
if (!resp.ok) throw new Error(`Update failed: ${resp.status}`);
console.log(await resp.json());<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/lists/{list_uuid}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Trusted office and VPN IPs'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/lists/{list_uuid}/"
payload := strings.NewReader("{\n \"name\": \"Trusted office and VPN IPs\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://verification.didit.me/v3/lists/{list_uuid}/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Trusted office and VPN IPs\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/lists/{list_uuid}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Trusted office and VPN IPs\"\n}"
response = http.request(request)
puts response.read_body{
"name": "Trusted office and VPN IPs",
"description": "Office egress ranges"
}Update List
PATCH /v3/lists//: rename or update the description of a Didit allowlist or custom list. System lists cannot be modified.
curl -X PATCH 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name": "Trusted office and VPN IPs"}'import os
import requests
list_uuid = '11111111-2222-3333-4444-555555555555'
resp = requests.patch(
f'https://verification.didit.me/v3/lists/{list_uuid}/',
headers={'x-api-key': os.environ['DIDIT_API_KEY']},
json={'name': 'Trusted office and VPN IPs'},
timeout=10,
)
resp.raise_for_status()
print(resp.json())const listUuid = '11111111-2222-3333-4444-555555555555';
const resp = await fetch(`https://verification.didit.me/v3/lists/${listUuid}/`, {
method: 'PATCH',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ name: 'Trusted office and VPN IPs' }),
});
if (!resp.ok) throw new Error(`Update failed: ${resp.status}`);
console.log(await resp.json());<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/lists/{list_uuid}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Trusted office and VPN IPs'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/lists/{list_uuid}/"
payload := strings.NewReader("{\n \"name\": \"Trusted office and VPN IPs\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://verification.didit.me/v3/lists/{list_uuid}/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Trusted office and VPN IPs\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/lists/{list_uuid}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Trusted office and VPN IPs\"\n}"
response = http.request(request)
puts response.read_body{
"name": "Trusted office and VPN IPs",
"description": "Office egress ranges"
}list_type and entry_type keep the values they were created with. System lists cannot be modified and return 400.
The response contains only name and description. Call Get list for the full list.Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Path Parameters
UUID of the list, as returned by List lists or Create a list.