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

# Update the comment on a team blacklisted number

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

Updates the comment (reason) associated with a blacklisted phone number in your team's shared 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. If the new comment is identical to the current one, the request returns `304 Not Modified`.

**Permission:** `Numbers Write` required.

**Monitoring:** **Required.** Team blacklist management is a supervisory feature. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

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

## Response `200`

Successful operation — comment updated.

## Other responses

- `304` — Comment unchanged (same as current).
- `401` — Unauthorized — invalid or missing API token, missing `Numbers Write` permission, or Monitoring is OFF.
- `404` — Phone number is not in the 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)