Delete Endpoints

Delete Endpoint

DELETE /v1/endpoints/{uuid}

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.

Historical traffic logs are retained per the user's plan retention policy.

Removing an endpoint of a WordPress app restarts the site so it picks up its new address (another endpoint, or its private preview URL when none is left): about a minute of downtime.

The DNS record ngris created for the endpoint (custom domains in automatic DNS mode, and dedicated-IP records) is removed in the background. The subdomain is free again immediately: you can create an endpoint with the same name right away.

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.

An endpoint the ngris team suspended (admin_suspended: true), or one paused over the plan's endpoint limit, is deleted like any other.

Path parameters

uuid string (uuid) Req

Endpoint UUID. Get from /endpoints.

Response (204 No Content)

No body.

Errors

401 Unauthorized

Missing auth.

404 Not Found

UUID doesn't exist or belongs to another user.

409 Conflict

endpoint in use by active tunnel — an agent is connected on it. Stop the agent, then delete.

500

Database error during teardown. The transaction rolls back (nothing is deleted); safe to retry.

Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e" \
  -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 — 204 No Content
(no body)

Was this helpful?

PreviousCreate Endpoint NextPromote Ephemeral Endpoint

On this page

Delete Endpoint

Was this helpful?