Deleting error pages¶

Warning

Deleted entries cannot be restored. To use an entry again after deletion, it must be created again.

Sends a DELETE request to the endpoint /domain/{domainId}/errorpages.

Description¶

The Delete-Error-Pages request deletes the error pages of one or more subdomains of a domain.

Requirements¶

Values of the request: Domain-ID {domainId}

Objects: ErrorPageUpdateVO

Request¶

To delete error pages, the Domain-ID {domainId} needs to be added to the path of the request.

For a detailed specification of which error pages are deleted, the object ErrorPageUpdateVO with the following attribute needs to be defined in the body:

Attributes	Description	Values
`selection`	The subdomains and error codes to delete. The attribute is keyed by subdomain name, then by error code, with a boolean that selects the error code.	`array`

Only error codes set to true are affected.

Example¶

Example request body:

{
  "selection": {
    "www.example.com": {
      "400": true,
      "500": true
    }
  }
}

Responses¶

The following responses are available:

STATUS CODE	DESCRIPTION
204	The request has succeeded and the element was successfully deleted.
400	The request was unsuccessful. The request was invalid or information is missing.
401	The request has not succeeded because the user authentication was incorrect.
403	The request has not succeeded because the user does not have the right permissions.