Uptimeify Docs
MonitorsDnsbl monitoring

Delete Customer IP

Deletes a customer IP.

DELETE /api/customer-ips/:customerIpPublicId

Notes:

  • Readonly users and global supporters cannot delete customer IPs.

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X DELETE "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer $TOKEN"

Example Response

{ "success": true }

Common errors

  • 400 Invalid IP identifier when :customerIpPublicId is neither a valid UUID nor a legacy numeric ID
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden for readonly/global supporter users, or when you cannot access the customer
  • 404 IP not found when the IP does not exist

Permissions

Closed to the readonly role. A read-only login deletes no IP, whatever its ownership class, and neither does an API token it issued: a token inherits the role of the user who created it. Editing a self_service IP stays open to that role.

A customer-scoped caller is bound by ownership class on top of that: a managed IP is refused with managed_by_organization unless its customer carries canEditManaged.

On this page