latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

blacklist

Update the comment on a team blacklisted number

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.

patch/blacklists/numbers/{phoneNumber}/comment/{newComment}

Path parameters

phoneNumberinteger required
Example:33612345678

Phone number in E.164 format without the + prefix (e.g., 33612345678).

newCommentstring required
Example:new_comment

The new comment text to associate with the blacklisted number (e.g., reason for blocking).

Response

Successful operation — comment updated.