---
title: "Add or update BlocklistItems To Text Blocklist"
method: POST
path: "/text/blocklists/{blocklistName}:addOrUpdateBlocklistItems"
---

# Add or update BlocklistItems To Text Blocklist

`POST /text/blocklists/{blocklistName}:addOrUpdateBlocklistItems`

Add or update blocklistItems to a text blocklist. You can add or update at most 100 blocklistItems in one request.

## Path parameters

- `blocklistName` string, required

## Query parameters

- `api-version` string, required

## Request body

- AddOrUpdateTextBlocklistItemsOptions — The request to add blocklistItems to a text blocklist.
  - `blocklistItems` TextBlocklistItem[], required — Array of blocklistItems to add.
    - `blocklistItemId` string, required — The service will generate a BlocklistItemId, which will be a UUID.
    - `description` string — BlocklistItem description.
    - `text` string, required — BlocklistItem content. The length is counted using Unicode code point.
    - `isRegex` boolean — An optional properties indicating whether this item is to be matched as a regular expression.

## Response `200`

The request has succeeded.

- AddOrUpdateTextBlocklistItemsResult — The response of adding blocklistItems to the text blocklist.
  - `blocklistItems` TextBlocklistItem[], required — Array of blocklistItems have been added.
    - `blocklistItemId` string, required — The service will generate a BlocklistItemId, which will be a UUID.
    - `description` string — BlocklistItem description.
    - `text` string, required — BlocklistItem content. The length is counted using Unicode code point.
    - `isRegex` boolean — An optional properties indicating whether this item is to be matched as a regular expression.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-contentsafety.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-contentsafety/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-contentsafety/revisions/d4969093cba0/schema)