---
title: Settings
---

[Skip to content](#_top)

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

[Schema Validation](https://developers.cloudflare.com/api/typescript/resources/schema_validation)

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_validation/subresources/settings/methods/get)

client.schemaValidation.settings.get(SettingGetParams {zone\_id } params, RequestOptionsoptions?): [SettingGetResponse](<https://developers.cloudflare.com/api/typescript/resources/schema_validation#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)>) {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_validation/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_validation#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)>) {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_validation/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_validation#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)>) {validation\_default\_mitigation\_action, validation\_override\_mitigation\_action }

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

##### ModelsExpand Collapse

<details>

<summary>

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

</summary>

<details>

<summary>

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

The default mitigation action used

Mitigation actions are as follows:

- <code>log</code> - log request when request does not conform to schema
- <code>block</code> - deny access to the site when request does not conform to schema
- <code>none</code> - skip running schema validation

</summary>

One of the following:

"none"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%200">Link to this property</a>

"log"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%201">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action">Link to this property</a>

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.

- <code>"none"</code> will skip running schema validation entirely for the request

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_override_mitigation_action">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_get_response%20%3E%20(schema)>)

<details>

<summary>

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

</summary>

<details>

<summary>

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

The default mitigation action used

Mitigation actions are as follows:

- <code>log</code> - log request when request does not conform to schema
- <code>block</code> - deny access to the site when request does not conform to schema
- <code>none</code> - skip running schema validation

</summary>

One of the following:

"none"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%200">Link to this property</a>

"log"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%201">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action">Link to this property</a>

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.

- <code>"none"</code> will skip running schema validation entirely for the request

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20validation_override_mitigation_action">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)>)

<details>

<summary>

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

</summary>

<details>

<summary>

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

The default mitigation action used

Mitigation actions are as follows:

- <code>log</code> - log request when request does not conform to schema
- <code>block</code> - deny access to the site when request does not conform to schema
- <code>none</code> - skip running schema validation

</summary>

One of the following:

"none"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%200">Link to this property</a>

"log"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%201">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)%20%3E%20(property)%20validation_default_mitigation_action">Link to this property</a>

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.

- <code>"none"</code> will skip running schema validation entirely for the request

<a href="#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)%20%3E%20(property)%20validation_override_mitigation_action">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings%20%3E%20(model)%20setting_edit_response%20%3E%20(schema)>)

#### SettingsOperations

##### [List per-operation schema validation settings](https://developers.cloudflare.com/api/typescript/resources/schema_validation/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_validation#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)>) {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_validation/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_validation#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)>) {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_validation/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_validation#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)>) {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_validation/subresources/settings/subresources/operations/methods/bulk_edit)

client.schemaValidation.settings.operations.bulkEdit(OperationBulkEditParams {zone\_id, body } params, RequestOptionsoptions?): [OperationBulkEditResponse](<https://developers.cloudflare.com/api/typescript/resources/schema_validation#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)>) {mitigation\_action }

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

##### [Delete per-operation schema validation setting](https://developers.cloudflare.com/api/typescript/resources/schema_validation/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_validation#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_delete_response%20%3E%20(schema)>) {operation\_id }

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

##### ModelsExpand Collapse

<details>

<summary>

OperationListResponse {mitigation\_action, operation\_id }

</summary>

<details>

<summary>

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

- <code>"log"</code> - log request when request does not conform to schema for this operation
- <code>"block"</code> - deny access to the site when request does not conform to schema for this operation
- <code>"none"</code> - will skip mitigation for this operation

</summary>

One of the following:

"log"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%201">Link to this property</a>

"none"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action">Link to this property</a>

operation\_id: string

UUID.

maxLength36

minLength36

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)%20%3E%20(property)%20operation_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)>)

<details>

<summary>

OperationGetResponse {mitigation\_action, operation\_id }

</summary>

<details>

<summary>

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

- <code>"log"</code> - log request when request does not conform to schema for this operation
- <code>"block"</code> - deny access to the site when request does not conform to schema for this operation
- <code>"none"</code> - will skip mitigation for this operation

</summary>

One of the following:

"log"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%201">Link to this property</a>

"none"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action">Link to this property</a>

operation\_id: string

UUID.

maxLength36

minLength36

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)%20%3E%20(property)%20operation_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_get_response%20%3E%20(schema)>)

<details>

<summary>

OperationUpdateResponse {mitigation\_action, operation\_id }

</summary>

<details>

<summary>

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

- <code>"log"</code> - log request when request does not conform to schema for this operation
- <code>"block"</code> - deny access to the site when request does not conform to schema for this operation
- <code>"none"</code> - will skip mitigation for this operation

</summary>

One of the following:

"log"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%201">Link to this property</a>

"none"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)%20%3E%20(property)%20mitigation_action">Link to this property</a>

operation\_id: string

UUID.

maxLength36

minLength36

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)%20%3E%20(property)%20operation_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_update_response%20%3E%20(schema)>)

<details>

<summary>

OperationBulkEditResponse = Record&lt;string, item&gt;

Operation ID to updated mitigation action mapping

</summary>

<details>

<summary>

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

When set, this applies a mitigation action to this operation

- <code>"log"</code> - log request when request does not conform to schema for this operation
- <code>"block"</code> - deny access to the site when request does not conform to schema for this operation
- <code>"none"</code> - will skip mitigation for this operation
- <code>null</code> - clears any mitigation action

</summary>

One of the following:

"log"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%201">Link to this property</a>

"none"

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20mitigation_action%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20mitigation_action">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_bulk_edit_response%20%3E%20(schema)>)

<details>

<summary>

OperationDeleteResponse {operation\_id }

</summary>

operation\_id?: string

UUID.

maxLength36

minLength36

<a href="#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_delete_response%20%3E%20(schema)%20%3E%20(property)%20operation_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20schema_validation.settings.operations%20%3E%20(model)%20operation_delete_response%20%3E%20(schema)>)