PUT /zones/{zone_id}/firewall-for-ai/custom-topics
Set the Firewall for AI custom topic categories for a zone.
A maximum of 20 custom topics can be configured per zone. Each topic label must be 2–20 characters using only lowercase letters (a–z), digits (0–9), and hyphens. Each topic description must be 2–50 printable ASCII characters.
Changes can take up to a minute to propagate to the zone.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
zone_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
topics[] |
Array | No |
Custom topic categories for Firewall for AI content detection. |
topics[].topic |
String | Yes |
Description of the topic category. Must contain only printable ASCII characters. |
topics[].label |
String | Yes |
Unique label identifier. Must contain only lowercase letters (a–z), digits (0–9), and hyphens. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.