Remove URL(s) from a specified URL Category

Note: Before you use this API, make sure to create the URL Categories override file by copying the file /usr/share/fa/data/plugins/panorama/url_categories.json to this location: /home/afa/.fa/plugins/panorama/.

Remove URL(s) from a specified URL Category in the URL Categories override file. Currently only Panorama devices are supported. Use the URL-categories-controller API GET /{category} method to return the list of available URL Categories.

For further information about the URL Categories override file see (optional) Enhance URL Category accuracy.

Resource Name: /api/v1/plugins/{brand}/URLcategory/{category}/URL

Request Method: DELETE

Request URL Parameters:

Element	Type	Description
brand Mandatory	string	Brand name code. Only "panorama" is supported.
category Mandatory	string	Specified URL Category to remove URL(s) from.

Request Body Parameters:

Element	Type	Description
body Mandatory	string	A JSON list of URLs to be removed from the URL Category. For example: Copy `[ "www.bing.com", "www.google.com" ]`

Element

Type

Description

body
Mandatory

string

A JSON list of URLs to be removed from the URL Category.

For example:

Copy

[
       "www.bing.com", 
       "www.google.com"
]

Response parameters

Element	Type	Description
categories	map of objects	The list of URL categories after URLs have been deleted, each populated by: URL Category name URLs and their IPs

Element

Type

Description

categories

map of objects

The list of URL categories after URLs have been deleted, each populated by:

URL Category name
URLs and their IPs

Response:

Status codes:

Code	Description
200	ActiveChange was triggered
400	Input validation failure
403	Authentication failure
500	Failed to complete operation.

Request cURL examples

curl -X DELETE "https://localhost1/afa/api/v1/plugins/panorama/URLCategory/search-engines/URL" -H "accept: */*" -H "Content-Type: application/json" -d "[ \"www.bing.com\", \"www.google.com\"]"

Response example for 200

Copy

{
  "categories": {
    "job-search": {
      "urls": {
        "www.indeed.com": [
          "169.45.207.200"
        ],
        "www.monster.com": [
          "65.9.100.58"
        ],
        "www.simplyhired.com": [
          "169.45.226.49"
        ]
      }
    },
    "abortion": {
      "urls": {
        "www.prochoice.org": [
          "130.211.137.150"
        ],
        "www.prochoiceamerica.org": [
          "104.198.98.23"
        ],
        "www.prolifeaction.org": [
          "104.21.63.237"
        ]
      }
    }
  }
}