Skip to content

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 for subdomains.

Example:"*.sub.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*"
POST
/v1/controls/blockedUrls
curl -i -X POST \
  https://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/*"