Add a new blocked URL

Request

Security

x-api-key

Bodyapplication/jsonrequired

A URL pattern used to block access to matching sites. A maximum of 2,000 blocked URLs is supported.

One of:

hoststringrequired

The host part of the URL pattern. This can be a domain or a subdomain. Wildcards (*) are supported anywhere in the host, including partial labels and the TLD (e.g. *.com, ai*.domain.com, example.*). Patterns that match every host, such as * or *.*, are not allowed.

Example:"*.domain.com"

pathstring

The path part of the URL pattern. Wildcards are supported. If not specified, the wildcard * is assumed, matching all paths for the given host.

Example:"/path/to*"

curl -i -X POST \
  https://eu1.api.pushsecurity.com/v1/controls/blockedUrls \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "host": "domain.com"
  }'

Responses

OK

Headers

any

Bodyapplication/json

string(Blocked URL)

This object represents a URL pattern used to block access to matching sites.

Response

"*://*.example.com/*"