Update URL Category

Updates the URL category for the specified ID. If keywords are included within the request, then they replace existing ones for the specified URL category. If the keywords attribute is not included the request, the existing keywords are retained.

You can perform a full update for the specified URL category. However, if attributes are omitted within the update request, the values for those attributes are cleared.

You can also perform an incremental update, to add or remove URLs, for the specified URL category using the action parameter. To learn more, see URL Categories Use Cases.

Parameters

Parameter	Description
Action	The action applied to the URL category (i.e. add or remove from category list). To learn more, see URL Categories Use Cases.
Category ID	The unique identifier for the URL category.
Custom Category	The new URL category as a JSON. Visit the ZIA reference for how this should look.

Example Output

{
    "id": "ANY",
    "configuredName": "string",
    "superCategory": "ANY",
    "keywords": [
        "string"
    ],
    "keywordsRetainingParentCategory": [
        "string"
    ],
    "urls": [
        "string"
    ],
    "dbCategorizedUrls": [
        "string"
    ],
    "ipRanges": [
        "string"
    ],
    "ipRangesRetainingParentCategory": [
        "string"
    ],
    "customCategory": false,
    "scopes": [
        {
            "scopeGroupMemberEntities": [
                {
                    "id": 0,
                    "name": "string",
                    "extensions": {
                        "additionalProp1": "string",
                        "additionalProp2": "string",
                        "additionalProp3": "string"
                    }
                }
            ],
            "Type": "ORGANIZATION",
            "ScopeEntities": [
                {
                    "id": 0,
                    "name": "string",
                    "extensions": {
                        "additionalProp1": "string",
                        "additionalProp2": "string",
                        "additionalProp3": "string"
                    }
                }
            ]
        }
    ],
    "editable": false,
    "description": "string",
    "type": "URL_CATEGORY",
    "urlKeywordCounts": {
        "totalUrlCount": 0,
        "retainParentUrlCount": 0,
        "totalKeywordCount": 0,
        "retainParentKeywordCount": 0
    },
    "customUrlsCount": 0,
    "urlsRetainingParentCategoryCount": 0,
    "customIpRangesCount": 0,
    "ipRangesRetainingParentCategoryCount": 0
}

Workflow Library Example

Update Url Category with Zscaler Internet Access and Send Results Via Email

Preview this Workflow on desktop