---
title: Settings
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Schema Validation](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Settings

##### [Get global schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/methods/get)

client.schemaValidation.settings.get(SettingGetParams { zone\_id } params, RequestOptionsoptions?): [SettingGetResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings%20%3E%20%28model%29%20setting%5Fget%5Fresponse%20%3E%20%28schema%29) { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

GET/zones/{zone\_id}/schema\_validation/settings

##### [Update global schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/methods/update)

client.schemaValidation.settings.update(SettingUpdateParams { zone\_id, validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } params, RequestOptionsoptions?): [SettingUpdateResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings%20%3E%20%28model%29%20setting%5Fupdate%5Fresponse%20%3E%20%28schema%29) { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

PUT/zones/{zone\_id}/schema\_validation/settings

##### [Edit global schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/methods/edit)

client.schemaValidation.settings.edit(SettingEditParams { zone\_id, validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } params, RequestOptionsoptions?): [SettingEditResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings%20%3E%20%28model%29%20setting%5Fedit%5Fresponse%20%3E%20%28schema%29) { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

PATCH/zones/{zone\_id}/schema\_validation/settings

##### ModelsExpand Collapse 

SettingGetResponse { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

validation\_default\_mitigation\_action: "none" | "log" | "block"

The default mitigation action used

Mitigation actions are as follows:

* `log` \- log request when request does not conform to schema
* `block` \- deny access to the site when request does not conform to schema
* `none` \- skip running schema validation

One of the following:

"none"

"log"

"block"

validation\_override\_mitigation\_action?: "none" | null

When not null, this overrides global both zone level and operation level mitigation actions. This can serve as a quick way to disable schema validation for the whole zone.

* `"none"` will skip running schema validation entirely for the request

SettingUpdateResponse { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

validation\_default\_mitigation\_action: "none" | "log" | "block"

The default mitigation action used

Mitigation actions are as follows:

* `log` \- log request when request does not conform to schema
* `block` \- deny access to the site when request does not conform to schema
* `none` \- skip running schema validation

One of the following:

"none"

"log"

"block"

validation\_override\_mitigation\_action?: "none" | null

When not null, this overrides global both zone level and operation level mitigation actions. This can serve as a quick way to disable schema validation for the whole zone.

* `"none"` will skip running schema validation entirely for the request

SettingEditResponse { validation\_default\_mitigation\_action, validation\_override\_mitigation\_action } 

validation\_default\_mitigation\_action: "none" | "log" | "block"

The default mitigation action used

Mitigation actions are as follows:

* `log` \- log request when request does not conform to schema
* `block` \- deny access to the site when request does not conform to schema
* `none` \- skip running schema validation

One of the following:

"none"

"log"

"block"

validation\_override\_mitigation\_action?: "none" | null

When not null, this overrides global both zone level and operation level mitigation actions. This can serve as a quick way to disable schema validation for the whole zone.

* `"none"` will skip running schema validation entirely for the request

#### SettingsOperations

##### [List per-operation schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/subresources/operations/methods/list)

client.schemaValidation.settings.operations.list(OperationListParams { zone\_id, page, per\_page } params, RequestOptionsoptions?): V4PagePaginationArray<[OperationListResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings.operations%20%3E%20%28model%29%20operation%5Flist%5Fresponse%20%3E%20%28schema%29) { mitigation\_action, operation\_id } \>

GET/zones/{zone\_id}/schema\_validation/settings/operations

##### [Get per-operation schema validation setting](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/subresources/operations/methods/get)

client.schemaValidation.settings.operations.get(stringoperationID, OperationGetParams { zone\_id } params, RequestOptionsoptions?): [OperationGetResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings.operations%20%3E%20%28model%29%20operation%5Fget%5Fresponse%20%3E%20%28schema%29) { mitigation\_action, operation\_id } 

GET/zones/{zone\_id}/schema\_validation/settings/operations/{operation\_id}

##### [Update per-operation schema validation setting](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/subresources/operations/methods/update)

client.schemaValidation.settings.operations.update(stringoperationID, OperationUpdateParams { zone\_id, mitigation\_action } params, RequestOptionsoptions?): [OperationUpdateResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings.operations%20%3E%20%28model%29%20operation%5Fupdate%5Fresponse%20%3E%20%28schema%29) { mitigation\_action, operation\_id } 

PUT/zones/{zone\_id}/schema\_validation/settings/operations/{operation\_id}

##### [Bulk edit per-operation schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/subresources/operations/methods/bulk%5Fedit)

client.schemaValidation.settings.operations.bulkEdit(OperationBulkEditParams { zone\_id, body } params, RequestOptionsoptions?): [OperationBulkEditResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings.operations%20%3E%20%28model%29%20operation%5Fbulk%5Fedit%5Fresponse%20%3E%20%28schema%29) { mitigation\_action } 

PATCH/zones/{zone\_id}/schema\_validation/settings/operations

##### [Delete per-operation schema validation setting](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation/subresources/settings/subresources/operations/methods/delete)

client.schemaValidation.settings.operations.delete(stringoperationID, OperationDeleteParams { zone\_id } params, RequestOptionsoptions?): [OperationDeleteResponse](https://developers.cloudflare.com/api/typescript/resources/schema%5Fvalidation#%28resource%29%20schema%5Fvalidation.settings.operations%20%3E%20%28model%29%20operation%5Fdelete%5Fresponse%20%3E%20%28schema%29) { operation\_id } 

DELETE/zones/{zone\_id}/schema\_validation/settings/operations/{operation\_id}

##### ModelsExpand Collapse 

OperationListResponse { mitigation\_action, operation\_id } 

mitigation\_action: "log" | "block" | "none"

When set, this applies a mitigation action to this operation which supersedes a global schema validation setting just for this operation

* `"log"` \- log request when request does not conform to schema for this operation
* `"block"` \- deny access to the site when request does not conform to schema for this operation
* `"none"` \- will skip mitigation for this operation

One of the following:

"log"

"block"

"none"

operation\_id: string

UUID.

maxLength36

minLength36

OperationGetResponse { mitigation\_action, operation\_id } 

mitigation\_action: "log" | "block" | "none"

When set, this applies a mitigation action to this operation which supersedes a global schema validation setting just for this operation

* `"log"` \- log request when request does not conform to schema for this operation
* `"block"` \- deny access to the site when request does not conform to schema for this operation
* `"none"` \- will skip mitigation for this operation

One of the following:

"log"

"block"

"none"

operation\_id: string

UUID.

maxLength36

minLength36

OperationUpdateResponse { mitigation\_action, operation\_id } 

mitigation\_action: "log" | "block" | "none"

When set, this applies a mitigation action to this operation which supersedes a global schema validation setting just for this operation

* `"log"` \- log request when request does not conform to schema for this operation
* `"block"` \- deny access to the site when request does not conform to schema for this operation
* `"none"` \- will skip mitigation for this operation

One of the following:

"log"

"block"

"none"

operation\_id: string

UUID.

maxLength36

minLength36

OperationBulkEditResponse \= Record<string, item\>

Operation ID to updated mitigation action mapping

mitigation\_action?: "log" | "block" | "none" | null

When set, this applies a mitigation action to this operation

* `"log"` \- log request when request does not conform to schema for this operation
* `"block"` \- deny access to the site when request does not conform to schema for this operation
* `"none"` \- will skip mitigation for this operation
* `null` \- clears any mitigation action

One of the following:

"log"

"block"

"none"

OperationDeleteResponse { operation\_id } 

operation\_id?: string

UUID.

maxLength36

minLength36