---
title: "Mute a host"
method: POST
path: "/api/v1/host/{host_name}/mute"
tags: ["Hosts"]
---

# Mute a host

`POST /api/v1/host/{host_name}/mute`

Mute a host. **Note:** This creates a [Downtime V2](https://docs.datadoghq.com/api/latest/downtimes/#schedule-a-downtime) for the host.

## Path parameters

- `host_name` string, required

## Request body

- HostMuteSettings — Combination of settings to mute a host.
  - `end` integer — POSIX timestamp in seconds when the host is unmuted. If omitted, the host remains muted until explicitly unmuted.
  - `message` string — Message to associate with the muting of this host.
  - `override` boolean — If true and the host is already muted, replaces existing host mute settings.

## Response `200`

OK

- HostMuteResponse — Response with the list of muted host for your organization.
  - `action` string — Action applied to the hosts.
  - `end` integer — POSIX timestamp in seconds when the host is unmuted.
  - `hostname` string — The host name.
  - `message` string — Message associated with the mute.

## Other responses

- `400` — Invalid Parameter Error
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)
