Request Domain Category Change.

POST 
/v1/domain/changerequest

A POST request to submit change requests for domains with their new categories. Batch limit is 20 entries per request with a maximum of 10 request submissions per 24 hour period (for a total of 200 individual domain change requests).

Request

application/json

Body

required

changeRequests object[]required
Provide a list of domain change request with domains, categories, comments.
Array [
comment string
Comment for change request review process.
domain string
Possible values: <= 253 characters
The domain name
suggestedCategory string
Possible values: [malware, command-and-control, phishing, dynamic-dns, grayware, parked, proxy-avoidance-and-anonymizers, benign]
Suggested new category for domain name. You must use one of the valid categories shown above.
]
email string

Provide an email to receive results of change requests. If none provided, email will assume value associated with DNS Security API key.

test boolean

Possible values: Value must match regular expression true | false

When set to true, this bulk change request will be acknowledged by API, but not forwarded for review

Responses

200

200 Ok

Response Headers

• X-Quota-Limit-Remaining integer

  The remaining number of quota in this window (per day). When it drops to 0, return HTTP StatusCode = 429

• X-Quota-Limit-Reset integer

  The unix timestamp at which the current quota window resets. Quota is refreshed every day.

• X-Quota-Limit-Total integer

  Total number of quota in this window (per day).

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

400

400 Bad Request

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "error message content...",
  "success": false
}

401

401 Unauthorized

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "Unauthorized",
  "success": false
}

403

403 Forbidden

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "Forbidden",
  "success": false
}

404

404 Not Found

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "Not Found",
  "success": false
}

415

415 Unsupported Media Type

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "Unsupported Media Type",
  "success": false
}

429

429 Too Many Requests

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "Too Many Requests",
  "success": false
}

500

500 Internal Error

application/json

Schema

Schema

message string
success boolean

Example (from schema)

{
  "message": "Change request has been successfully submitted.",
  "success": true
}

response

{
  "message": "error message...",
  "success": false
}

Loading...