# Delete a custom hostname

Deletes a custom hostname and all its associated details. This is an irreversible operation.

Endpoint: DELETE /api/admin/v1/hostnames/{hostname}
Version: 1.0
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Path parameters:

  - `hostname` (string, required)
    The specific custom hostname you want to interact with.

## Response 204:

  - `204` (unknown)
    No Content

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 400

  - `title` (string, required)
    The error description.
    Example: BAD REQUEST

  - `detail` (string, required)
    The error details.
    Example: URL format is invalid

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com

## Response 401:

  - `401` (unknown)
    Unauthorized request

## Response 401 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 401

  - `title` (string, required)
    The error description.
    Example: UNAUTHORIZED

  - `detail` (string, required)
    The error details.
    Example: Authentication credentials are required to access the resource. All requests must be authenticated.

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7235#section-3.1

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com

## Response 403:

  - `403` (unknown)
    Forbidden request

## Response 403 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 403

  - `title` (string, required)
    The error description.
    Example: FORBIDDEN

  - `detail` (string, required)
    The error details.
    Example: No access to the requested resource

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.3

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com

## Response 404:

  - `404` (unknown)
    Resource not found

## Response 404 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 404

  - `title` (string, required)
    The error description.
    Example: RESOURCE NOT FOUND

  - `detail` (string, required)
    The error details.
    Example: The specified resource does not exist.

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.4

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 422

  - `title` (string, required)
    The error description.
    Example: UNPROCESSABLE ENTITY

  - `detail` (string, required)
    The error details.
    Example: The maximum number of custom hostnames has been reached.

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 500 fields (application/json):

  - `status` (integer, required)
    The HTTP response status code.
    Example: 500

  - `title` (string, required)
    The error description.
    Example: INTERNAL SERVER ERROR

  - `detail` (string, required)
    The error details.
    Example: The server was unable to complete your request. Please try again later.

  - `type` (string, required)
    URL to get more information about the error.
    Example: https://datatracker.ietf.org/doc/html/rfc7231#section-6.6.1

  - `instance` (string, required)
    The instance where the error was encountered.
    Example: https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com