---
title: "Update Customer Domain"
description: "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

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

## Example (cURL)

```bash
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