---
title: Fleet Automation
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Fleet Automation
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Fleet Automation

Manage automated deployments across your fleet of hosts.

Fleet Automation provides two types of deployments:

Configuration Deployments (`/configure`):

- Apply configuration file changes to target hosts
- Support merge-patch operations to update specific configuration fields
- Support delete operations to remove configuration files
- Useful for updating Datadog Agent settings, integration configs, and more

Package Upgrade Deployments (`/upgrade`):

- Upgrade the Datadog Agent to specific versions

## [List available Datadog Agent versions →](https://docs.datadoghq.com/api/latest/fleet-automation/list-available-datadog-agent-versions.md){% #list-available-datadog-agent-versions %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/agent_versions |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/agent_versions |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/agent_versions      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/agent_versions      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/agent_versions  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/agent_versions |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/agent_versions     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/agent_versions |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/agent_versions |

## [List all Datadog Agents →](https://docs.datadoghq.com/api/latest/fleet-automation/list-all-datadog-agents.md){% #list-all-datadog-agents %}

| Datadog site      | API endpoint                                          |
| ----------------- | ----------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/agents |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/agents |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/agents      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/agents      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/agents  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/agents |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/agents     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/agents |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/agents |

## [Get detailed information about an agent →](https://docs.datadoghq.com/api/latest/fleet-automation/get-detailed-information-about-an-agent.md){% #get-detailed-information-about-an-agent %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/agents/{agent_key} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/agents/{agent_key} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/agents/{agent_key}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/agents/{agent_key}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/agents/{agent_key}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/agents/{agent_key} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/agents/{agent_key}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/agents/{agent_key} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/agents/{agent_key} |

## [List all deployments →](https://docs.datadoghq.com/api/latest/fleet-automation/list-all-deployments.md){% #list-all-deployments %}

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/deployments |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/deployments |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/deployments      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/deployments      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/deployments  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/deployments |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/deployments     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/deployments |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/deployments |

## [Create a configuration deployment →](https://docs.datadoghq.com/api/latest/fleet-automation/create-a-configuration-deployment.md){% #create-a-configuration-deployment %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/fleet/deployments/configure |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/fleet/deployments/configure |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/fleet/deployments/configure      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/fleet/deployments/configure      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/fleet/deployments/configure  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/fleet/deployments/configure |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/fleet/deployments/configure     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/fleet/deployments/configure |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/fleet/deployments/configure |

## [Upgrade hosts →](https://docs.datadoghq.com/api/latest/fleet-automation/upgrade-hosts.md){% #upgrade-hosts %}

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/fleet/deployments/upgrade |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/fleet/deployments/upgrade |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/fleet/deployments/upgrade      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/fleet/deployments/upgrade      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/fleet/deployments/upgrade  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/fleet/deployments/upgrade |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/fleet/deployments/upgrade     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/fleet/deployments/upgrade |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/fleet/deployments/upgrade |

## [Get a deployment by ID →](https://docs.datadoghq.com/api/latest/fleet-automation/get-a-deployment-by-id.md){% #get-a-deployment-by-id %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/deployments/{deployment_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/deployments/{deployment_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/deployments/{deployment_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/deployments/{deployment_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/deployments/{deployment_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/deployments/{deployment_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/deployments/{deployment_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/deployments/{deployment_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/deployments/{deployment_id} |

## [Cancel a deployment →](https://docs.datadoghq.com/api/latest/fleet-automation/cancel-a-deployment.md){% #cancel-a-deployment %}

| Datadog site      | API endpoint                                                                       |
| ----------------- | ---------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/fleet/deployments/{deployment_id}/cancel      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/fleet/deployments/{deployment_id}/cancel      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/fleet/deployments/{deployment_id}/cancel  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/fleet/deployments/{deployment_id}/cancel |

## [List all schedules →](https://docs.datadoghq.com/api/latest/fleet-automation/list-all-schedules.md){% #list-all-schedules %}

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/schedules |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/schedules |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/schedules      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/schedules      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/schedules  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/schedules |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/schedules     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/schedules |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/schedules |

## [Create a schedule →](https://docs.datadoghq.com/api/latest/fleet-automation/create-a-schedule.md) preview{% #create-a-schedule %}

| Datadog site      | API endpoint                                                    |
| ----------------- | --------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/unstable/fleet/schedules |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/unstable/fleet/schedules |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/unstable/fleet/schedules      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/unstable/fleet/schedules      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/unstable/fleet/schedules  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/unstable/fleet/schedules |
| app.datadoghq.com | POST https://api.datadoghq.com/api/unstable/fleet/schedules     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/unstable/fleet/schedules |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/unstable/fleet/schedules |

## [Get a schedule by ID →](https://docs.datadoghq.com/api/latest/fleet-automation/get-a-schedule-by-id.md){% #get-a-schedule-by-id %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/fleet/schedules/{id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/fleet/schedules/{id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/fleet/schedules/{id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/fleet/schedules/{id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/fleet/schedules/{id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/fleet/schedules/{id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/fleet/schedules/{id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/fleet/schedules/{id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/fleet/schedules/{id} |

## [Update a schedule →](https://docs.datadoghq.com/api/latest/fleet-automation/update-a-schedule.md) preview{% #update-a-schedule %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/unstable/fleet/schedules/{id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/unstable/fleet/schedules/{id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/unstable/fleet/schedules/{id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/unstable/fleet/schedules/{id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/unstable/fleet/schedules/{id}  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/unstable/fleet/schedules/{id} |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/unstable/fleet/schedules/{id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/unstable/fleet/schedules/{id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/unstable/fleet/schedules/{id} |

## [Delete a schedule →](https://docs.datadoghq.com/api/latest/fleet-automation/delete-a-schedule.md) preview{% #delete-a-schedule %}

| Datadog site      | API endpoint                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/unstable/fleet/schedules/{id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/unstable/fleet/schedules/{id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/unstable/fleet/schedules/{id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/unstable/fleet/schedules/{id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/unstable/fleet/schedules/{id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/unstable/fleet/schedules/{id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/unstable/fleet/schedules/{id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/unstable/fleet/schedules/{id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/unstable/fleet/schedules/{id} |

## [Trigger a schedule deployment →](https://docs.datadoghq.com/api/latest/fleet-automation/trigger-a-schedule-deployment.md) preview{% #trigger-a-schedule-deployment %}

| Datadog site      | API endpoint                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/unstable/fleet/schedules/{id}/trigger      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/unstable/fleet/schedules/{id}/trigger      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/unstable/fleet/schedules/{id}/trigger  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger |
| app.datadoghq.com | POST https://api.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/unstable/fleet/schedules/{id}/trigger |

## [List all fleet tracers →](https://docs.datadoghq.com/api/latest/fleet-automation/list-all-fleet-tracers.md) preview{% #list-all-fleet-tracers %}

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/unstable/fleet/tracers |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/unstable/fleet/tracers |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/unstable/fleet/tracers      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/unstable/fleet/tracers      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/unstable/fleet/tracers  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/unstable/fleet/tracers |
| app.datadoghq.com | GET https://api.datadoghq.com/api/unstable/fleet/tracers     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/unstable/fleet/tracers |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/unstable/fleet/tracers |

## [List tracers for a specific agent →](https://docs.datadoghq.com/api/latest/fleet-automation/list-tracers-for-a-specific-agent.md) preview{% #list-tracers-for-a-specific-agent %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/unstable/fleet/agents/{agent_key}/tracers      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/unstable/fleet/agents/{agent_key}/tracers      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/unstable/fleet/agents/{agent_key}/tracers  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers |
| app.datadoghq.com | GET https://api.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/unstable/fleet/agents/{agent_key}/tracers |