Skip to main content

Extend a list of domains in Cyber Shield Block List

Description

An endpoint to add domains to the Block List of Cyber Shield. For example:

POST /api/beta/cybershield/block-list-add-domains
{
  "domainAndComments": [
    { "domain": "sample.domain.com", "comment": "Added by CVE-YYYY-NNNN."}
  ]
}

This request is going to add or replace the existing entry in the Cyber Shield Block List with the domain sample.domain.com and add a comment # Added by CVE-YYYY-NNNN, resulting in the following line: sample.domain.com # Added by CVE-YYYY-NNNN.

Duplicates are going to be overwritten by the last entry. Already existing domains are going to be overwritten by the received ones.

domainAndComments (Type: List) - A list of domains with comments to add. Max 1000 items. (mandatory).

domain - An FQDN domain name. Unique in the list. The last domain entry overwrites the previous domains. domain and comment joined max length is 150 symbols. (mandatory)

comment - A free-form text string with details for a domain. Is added as a comment after the domain. domain and comment joined max length is 150 symbols. (optional)

Parameters

Name

In

Type

Required

Description

body

body

object

true

body

Body parameter
{
  "domainAndComments": [
    {
      "comment": "string",
      "domain": "string"
    }
  ]
}

Responses

Status

Meaning

Description

200

OK

OK

201

Created

Entity created

400

Bad Request

Bad Request

401

Unauthorized

Unauthorized

403

Forbidden

Access Forbidden

404

Not Found

Not Found

406

Not Acceptable

Not Acceptable

429

Too Many Requests

Too Many Requests

500

Internal Server Error

Internal Server Error

To perform this operation, you must be authenticated by means of one of the following methods: OAuth_authorization