---
title: Target Environments
---

[Skip to content](#_top)

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

[Vulnerability Scanner](https://developers.cloudflare.com/api/resources/vulnerability_scanner)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Target Environments

##### [List target environments](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/list)

GET/accounts/{account\_id}/vuln\_scanner/target\_environments

##### [Create target environment](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/create)

POST/accounts/{account\_id}/vuln\_scanner/target\_environments

##### [Get target environment](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/get)

GET/accounts/{account\_id}/vuln\_scanner/target\_environments/{target\_environment\_id}

##### [Update target environment](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/update)

PUT/accounts/{account\_id}/vuln\_scanner/target\_environments/{target\_environment\_id}

##### [Edit target environment](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/edit)

PATCH/accounts/{account\_id}/vuln\_scanner/target\_environments/{target\_environment\_id}

##### [Delete target environment](https://developers.cloudflare.com/api/resources/vulnerability_scanner/subresources/target_environments/methods/delete)

DELETE/accounts/{account\_id}/vuln\_scanner/target\_environments/{target\_environment\_id}

##### ModelsExpand Collapse

<details>

<summary>

TargetEnvironmentListResponse object {id, name, target, description }

</summary>

id: string

Target environment identifier.

formatuuid

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

target: object {type, zone\_tag }

Identifies the Cloudflare asset to scan. Uses a <code>type</code> discriminator. Currently the service supports only <code>zone</code> targets.

</summary>

type: "zone"

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20type">Link to this property</a>

zone\_tag: string

Cloudflare zone tag. The zone must belong to the account.

maxLength32

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20zone_tag">Link to this property</a>

</details>

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

description: optional string

Optional description providing additional context.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

</details>

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_list_response%20%3E%20(schema)>)

<details>

<summary>

TargetEnvironmentCreateResponse object {id, name, target, description }

</summary>

id: string

Target environment identifier.

formatuuid

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

target: object {type, zone\_tag }

Identifies the Cloudflare asset to scan. Uses a <code>type</code> discriminator. Currently the service supports only <code>zone</code> targets.

</summary>

type: "zone"

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20type">Link to this property</a>

zone\_tag: string

Cloudflare zone tag. The zone must belong to the account.

maxLength32

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20zone_tag">Link to this property</a>

</details>

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

description: optional string

Optional description providing additional context.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

</details>

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_create_response%20%3E%20(schema)>)

<details>

<summary>

TargetEnvironmentGetResponse object {id, name, target, description }

</summary>

id: string

Target environment identifier.

formatuuid

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

target: object {type, zone\_tag }

Identifies the Cloudflare asset to scan. Uses a <code>type</code> discriminator. Currently the service supports only <code>zone</code> targets.

</summary>

type: "zone"

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20type">Link to this property</a>

zone\_tag: string

Cloudflare zone tag. The zone must belong to the account.

maxLength32

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20zone_tag">Link to this property</a>

</details>

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

description: optional string

Optional description providing additional context.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

</details>

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_get_response%20%3E%20(schema)>)

<details>

<summary>

TargetEnvironmentUpdateResponse object {id, name, target, description }

</summary>

id: string

Target environment identifier.

formatuuid

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

target: object {type, zone\_tag }

Identifies the Cloudflare asset to scan. Uses a <code>type</code> discriminator. Currently the service supports only <code>zone</code> targets.

</summary>

type: "zone"

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20type">Link to this property</a>

zone\_tag: string

Cloudflare zone tag. The zone must belong to the account.

maxLength32

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20zone_tag">Link to this property</a>

</details>

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

description: optional string

Optional description providing additional context.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

</details>

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_update_response%20%3E%20(schema)>)

<details>

<summary>

TargetEnvironmentEditResponse object {id, name, target, description }

</summary>

id: string

Target environment identifier.

formatuuid

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

target: object {type, zone\_tag }

Identifies the Cloudflare asset to scan. Uses a <code>type</code> discriminator. Currently the service supports only <code>zone</code> targets.

</summary>

type: "zone"

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20type">Link to this property</a>

zone\_tag: string

Cloudflare zone tag. The zone must belong to the account.

maxLength32

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20target%20%3E%20(property)%20zone_tag">Link to this property</a>

</details>

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

description: optional string

Optional description providing additional context.

<a href="#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

</details>

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_edit_response%20%3E%20(schema)>)

TargetEnvironmentDeleteResponse = unknown

[Link to this property](<#(resource)%20vulnerability_scanner.target_environments%20%3E%20(model)%20target_environment_delete_response%20%3E%20(schema)>)