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).
Response (200 OK)
items array
Eligible endpoints. Each:
{endpoint_uuid, subdomain, domain_name}, ordered by subdomain. Send the endpoint_uuid in the path of POST /v1/endpoints/{uuid}/dedicated-ip; cross-reference with /endpoints for full records.Deprecated: until the sunset this response also carries the legacy integer endpoint_id field. Don't use it; read endpoint_uuid.
Errors
401 Unauthorized
Missing auth.
Request
curl "https://api.ngris.com/v1/dedicated-ips/attachable-endpoints" \
-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")
for ep in result["items"]:
print(f"{ep['endpoint_uuid']} {ep['subdomain']}.{ep['domain_name']}")
Response — 200 OK
{
"items": [
{
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"subdomain": "myapp",
"domain_name": "ngris.io"
}
]
}
Was this helpful?