---
title: "Update Customer IP"
description: "Updates a customer IP (e.g. label or status)."
---

`PATCH /api/customer-ips/:customerIpPublicId`

Notes:

- Readonly users and global supporters cannot update customer IPs.
- Activating an IP can be denied when quota limits are reached.

## Request Body

```json
{
  "label": "Mail Server",
  "status": "active"
}
```

## Example (cURL)

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

curl -X PATCH "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label":"Mail Server","status":"active"}'
```

## Response

Returns the updated customer IP record.

## Common errors

- `400 Invalid IP identifier` when `:customerIpPublicId` is neither a valid UUID nor a legacy numeric ID
- `400` body validation errors (e.g. invalid `status`)
- `401 Unauthorized` when you are not logged in
- `403 Forbidden` for readonly/global supporter users, or when you cannot access the customer
- `403 Active IP limit reached...` when activating would exceed your quota
- `404 IP not found` when the IP does not exist