---
title: "Delete a host"
method: DELETE
path: "/hosts/{host}"
tags: ["Hosts"]
---

# Delete a host

`DELETE /hosts/{host}`

## Request

- Base URL: `https://api.spectate.net/v1`
- URL: `https://api.spectate.net/v1/hosts/{host}`
- Auth: HTTP bearer

The host disappears from the API and the dashboard, and data its agent still sends is
refused (the agent stops itself). Uninstall the agent on the server too. Seven days later
the host is deleted permanently with all its data: metrics, alerts and metric condition
links. Until then support can restore it on request. Deleting the same host again returns
`404`.

## Path parameters

- `host` string, uuid, required

## Response `204`

No content

## Other responses

- `401`: `UNAUTHENTICATED`: no token was sent. `INVALID_TOKEN`: the token is unknown or revoked. `TOKEN_EXPIRED`: the token has expired.
- `403`: `FORBIDDEN`: the token lacks an ability this endpoint requires (listed in `details.required_abilities`). `TEAM_PENDING_DELETION`: the team is scheduled for deletion. `TEAM_SUSPENDED`: Spectate suspended the team.
- `404`: `RESOURCE_NOT_FOUND`: there is no such resource in this team.
- `429`: `RATE_LIMITED`: too many requests for this token. Wait for the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/spectate/apis/spectate-api.md) - [All operations](https://skmtc.dev/spectate/apis/spectate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spectate/apis/spectate-api/revisions/9b1a233997de?raw)