---
title: "Service: /hosts/{hostname} [DELETE]"
source: https://dev.pageseeder.com/api/services/host_delete.html
description: "Deletes a host from the system and removes it from internal mail hosts. The hostname is case-insensitive. Requires administrator permissions. Returns 400 if the host is referenced by URIs or group URIs."
last_updated: 2026-09-08T13:54:47+10:00
document_type: api_endpoint
operation_id: host-DELETE
resource_id: host
path_template: /hosts/{hostname}
http_method: DELETE
api_category: host
implementation_version: 6.2004
api_since: 5.8900
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~176
---

# /hosts/\{hostname\} \[DELETE\]

## Description

Deletes a host.

When a host is deleted it is also removed from the list of internal mail hosts.

The *hostname* is not case sensitive so (`example.org` is the same as `EXAMPLE.ORG`)

> **Warning:** You cannot delete a host if it is still referenced by a URI or Group URI

## Parameters

No parameters defined.

## Permission

This service requires administrator.

## Response

If successful, this service always returns the following:

```xml

<host-delete/>
```

## Error Handling

| HTTP code | Error condition |
| --- | --- |
| 404 | If the hostname does not exist |
| 400 | Host is still being used by a URI or group URI and cannot be deleted. |