List Attachable Endpoints
List endpoints that are eligible to receive a dedicated IP. The dashboard's "attach IP" dropdown uses this to filter out ineligible endpoints. Eligibility rules:
- Endpoint must be
active(notprovisioning/error/disabled). - Endpoint must be permanent (not
ephemeral). - Endpoint must not already have a dedicated IP attached.
- Endpoint's region must match at least one of the user's allocated dedicated IPs (or you'd attach an IP from one region to an endpoint in another, which doesn't work).
Query parameters
ip_id int64
Optional. If set, narrow to endpoints whose region matches this specific IP. Use to populate the "which endpoint do I attach this IP to?" dropdown.
Response (200 OK)
items array
Eligible endpoints. Each:
{endpoint_uuid, subdomain, public_url, region, protocol}. Cross-reference with /endpoints for full records.Errors
401 Unauthorized
Missing auth.
Request
curl "https://api.ngris.com/v1/dedicated-ips/attachable-endpoints?ip_id=7" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
result = client._get_raw(
"/dedicated-ips/attachable-endpoints",
params={"ip_id": 7},
)
for ep in result["items"]:
print(f"{ep['public_url']} ({ep['region']})")
Response — 200 OK
{
"items": [
{
"endpoint_uuid": "abc-123",
"subdomain": "myapp",
"public_url": "https://myapp.ngris.io",
"region": "eu-north-1",
"protocol": "http"
}
]
}