---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v1/host/{host_name}/mute`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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.dev/datadog/apis/datadog-api-v1-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/revisions/ca5871004d26?raw)