---
title: "Update the comment on a user's blacklisted number"
method: PATCH
path: "/users/{userId}/blacklists/numbers/{phoneNumber}/comment/{newComment}"
tags: ["blacklist"]
---

# Update the comment on a user's blacklisted number

`PATCH /users/{userId}/blacklists/numbers/{phoneNumber}/comment/{newComment}`

Updates the comment (reason) associated with a blacklisted phone number in a user's personal blacklist. The new comment is passed directly in the URL path. Use this to add or modify the reason why a number was blocked without removing and re-adding the entry.

**Permission:** `Users Write` required.

**Monitoring impact:**
- **OFF:** Can only update comments on **your own** blacklist entries.
- **ON:** Can update comments on **any user's** blacklist entries.

## Path parameters

- `userId` integer, required
- `phoneNumber` integer, required
- `newComment` string, required

## Response `200`

Successful operation

## Other responses

- `304` — The comment is unchanged (same as the current value)
- `401` — Authentication token is missing, invalid, expired, or Users Write permission is missing
- `404` — The phone number is not in the user's blacklist
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)