Label

Label
Label

A single tag applied to an API endpoint. User-defined labels can be created to organize endpoints, while built-in labels can be used to enable specific protections such as bot blocking or check deactivation.

JSON Example
{
    "description": "string",
    "match_action_scopes": [
        "string"
    ],
    "name": "string",
    "type": "string"
}
string
description
Optional

Description of this label. Field introduced in 32.1.4. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

array of string
match_action_scopes
Optional

Defines the policy scope where this label can be used. When specified, the label is restricted to configuration within that policy type only. For example, if set to 'WafPolicy', this label can only be configured and referenced within WAF policies. Enum options - MATCH_ACTION_SCOPE_GENERIC, MATCH_ACTION_SCOPE_APIPOLICY, MATCH_ACTION_SCOPE_WAFPOLICY, MATCH_ACTION_SCOPE_HTTPSECURITYPOLICY, MATCH_ACTION_SCOPE_HTTPREQUESTPOLICY, MATCH_ACTION_SCOPE_HTTPRESPONSEPOLICY, MATCH_ACTION_SCOPE_CSRFPOLICY, MATCH_ACTION_SCOPE_AUTHPROFILE, MATCH_ACTION_SCOPE_VSDATASCRIPTSET, MATCH_ACTION_SCOPE_BOTDETECTIONPOLICY. Field introduced in 32.1.4. Minimum of 1 items required. Maximum of 1 items allowed. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

string
name
Required  

Label name used as a match condition in policies. Field introduced in 32.1.4. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

string
type
Optional
Constraints: default: LABEL_USER_DEFINED

The type of this label (system-defined or user-defined). Enum options - LABEL_SYSTEM_DEFINED, LABEL_USER_DEFINED. Field introduced in 32.1.4. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

Property Of