Uptimeify Docs
MonitorsDomain expiry monitoring

Update Customer Domain

Updates a customer domain (e.g. label, status, expiry thresholds).

PATCH /api/customer-domains/:customerDomainPublicId

Notes:

  • Readonly users and global supporters cannot update customer domains.
  • Activating a disabled domain can be denied when quota limits are reached.

Request Body

{
  "label": "Main Domain",
  "status": "active",
  "expiryWarningDays": 30,
  "expiryErrorDays": 7
}

Example (cURL)

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

curl -X PATCH "$BASE_URL/api/customer-domains/22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"active"}'

Response

Returns the updated customer domain record.

Common errors

  • 400 body validation errors (e.g. invalid thresholds)
  • 400 Invalid Domain identifier when :customerDomainPublicId 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 domain/customer
  • 403 Active domain limit reached... when activating would exceed your quota
  • 404 Domain not found when the domain does not exist

On this page