Delete Endpoint
Permanently remove an endpoint and all of its dependent resources: traffic policies, routing rules, attached OAuth providers, RBAC clients/roles, dedicated IP attachments, mTLS configuration, and per-endpoint API keys are all torn down in the same transaction.
Any agent currently connected via this endpoint is force-disconnected — its handshake fails on the next reconnect attempt. Public DNS for the subdomain stops resolving immediately. Historical traffic logs are retained per the user's plan retention policy.
Visibility rules: regular users can only delete their own endpoints (returns 404 for someone else's UUID, never 403, to avoid existence leak); admins can delete any.
Path parameters
id string (uuid) Req
Endpoint UUID. Get from /endpoints.
Response (200 OK)
success boolean
true on successful deletion.message string
Human-readable confirmation.
Errors
401 Unauthorized
Missing auth.
404 Not Found
UUID doesn't exist or belongs to another user.
500
Database error during teardown. The transaction rolls back; safe to retry.
Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/9f1a3c00-5b7f-4f12-8c46-2c7dab5f1234" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.endpoints.delete("<endpoint_uuid>")
# Idempotent — a 404 (already deleted) is treated as success.
Response — 200 OK
{
"success": true,
"message": "Endpoint deleted"
}