Add Custom Category
Adds a new custom URL category. If keywords are included within the request, they are added to the new category.
Delete Custom Category
Deletes the custom URL category for the specified ID. You cannot delete a custom category while it is being used by a URL policy or NSS feed. Also, predefined categories cannot be deleted.
Get Lite URL Categories
Gets a lightweight key-value list of all or custom URL categories.
Get URL Categories
Gets the URL category information for the specified ID.
Get URL Category
Gets information about all or custom URL categories. By default, the response includes keywords.
Get URL Quota
Gets information on the number of unique URLs that are currently provisioned for your organization as well as how many URLs you can add before reaching that number.
Search Ur Ls Classification
Retrieve Zscaler's default classification for a given set of URLs (e.g., ['abc.com', 'xyz.com']). Note : Custom URL classification is not returned by this request. Any URLs that are not categorized under a predefined URL category return a value of MISCELLANEOUS_OR_UNKNOWN . Up to 100 URLs can be looked up per request, and a URL cannot exceed 1,024 characters.
Update 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 .
URL Category Resource Get Categories With Matching Domains
For the specified list of URLs, finds matching entries present in existing custom URL categories. This endpoint allows you to review URLs for potential matches in existing categories to group-related entries in a single category. The URLs specified are matched against the entries present in urls (referred as Custom URLs in the UI) and dbCategorizedUrls (referred as URLs Retaining Parent Category in the UI) fields of custom URL categories. The matches are returned only for URLs of Subdomain type that match with existing wildcard entries and not vice versa. The only exception is when a wildcard URL is matched against another wildcard entry, but the former is identified as a subdomain in relation to the wildcard match. For example, if a URL such as .teams.microsoft.com matches with .microsoft.com , the .teams.microsoft.com entry in this case is regarded as a subdomain in relation to the match found and is returned as part of the API response. However, if .teams.microsoft.com matches with teams.microsoft.com , this becomes a wildcard match against a subdomain and is discarded in the response. Note : A maximum of 100 URLs can be sent in a request. The matches found through this request can be added to the required custom URL categories using the PUT /urlCategories/review/domains request.
URL Category Resource Update Categories With Matching Domains
Adds the list of matching URLs fetched by POST /urlCategories/review/domains to the specified custom URL categories. The URL specified is added to either urls (referred to as Custom URLs in the UI) or dbCategorizedUrls (referred to as URLs Retaining Parent Category in the UI) fields of the custom category based on the following condition: If the matching URL is present in the dbCategorizedUrls field, the new entry is added to this field. Otherwise, it is added to the urls field. Note : A maximum of 100 URL categories can be updated at once using this request. Only URLs that are of Subdomain type can be added to custom categories via this request. Wildcard matches cannot be added. To learn more, see the description for POST /urlCategories/review/domains .