Add Whitelisted IPs
Adds up to 10 IP addresses per request.
Limit
You can add up to 10 IP addresses per request.
Add IP addresses to your whitelist to allow them to access your Geonode proxy services without authentication.
Request
curl -X POST "https://app-api.geonode.com/api/configuration/active/whitelisted-ips" \
-H "Authorization: Basic base64(username:password)" \
-H "Content-Type: application/json" \
-d '{"ips": [{"ip": "161.142.148.140", "description": "mac-m1"}]}'Request Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
ips | array | Yes | List of IP objects to add to the whitelist |
ips[].ip | string | Yes | The IP address being added to the whitelist |
ips[].description | string | No | A user-defined label or identifier for the IP |
Example Request Body
{
"ips": [
{
"ip": "161.142.148.140",
"description": "mac-m1"
}
]
}Response
200 Success
The IP addresses have been successfully added to your whitelist.
Response Fields
| Field | Type | Description |
|---|---|---|
data | array | A list of successfully whitelisted IP addresses |
data[].ip | string | The IP address that was whitelisted |
data[].description | string | A user-defined label or identifier for the IP |
data[]._id | string | A unique identifier assigned to the whitelisted IP |
message | object | Details about the status of the whitelist update |
message.title | string | A short title summarizing the update status |
message.body | string | A message detailing the outcome of the operation |
message.variant | string | The status variant indicating success or failure |
Example Response
{
"data": [
{
"ip": "161.142.148.150",
"description": "updated-description",
"_id": "67a0a5bbb412ddaf6f139b3b"
}
],
"message": {
"title": "Updated",
"body": "Whitelisted IPs saved.",
"variant": "success"
}
}Error Responses
400 Bad Request
Invalid input data provided.
| Field | Type | Description |
|---|---|---|
error | string | Error message |
{
"error": "Invalid input data."
}401 Unauthorized
Invalid API credentials provided.
| Field | Type | Description |
|---|---|---|
error | string | Error message |
{
"error": "Unauthorized - Invalid API key or credentials."
}