For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/app-builder/revert-app.md. A documentation index is available at /llms.txt.
Language
Datadog site
CAUTIONThis product is not supported for your selected Datadog site. (US2-FED).

Revert App

POSThttps://api.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.us3.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.us5.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.datadoghq.eu/api/v2/app-builder/apps/{app_id}/reverthttps://api.ap1.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.ap2.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.uk1.datadoghq.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.ddog-gov.com/api/v2/app-builder/apps/{app_id}/reverthttps://api.us2.ddog-gov.com/api/v2/app-builder/apps/{app_id}/revert

Overview

Revert an app to a previous version. The version to revert to is selected through the version query parameter. The reverted version becomes the new latest version of the app.

This endpoint requires the apps_write permission.

Arguments

Path Parameters

Name
Type
Description
app_id [required]
string

The ID of the app.

Query Strings

Name
Type
Description
version [required]
string

The version number of the app to revert to. Cannot be latest. The special value deployed can be used to revert to the currently published version.

Response

OK

The response object after an app is successfully updated.

Field
Type
Description
data
object

The data object containing the updated app definition.

included
[object]

Data on the version of the app that was published.

meta
object

Metadata of an app.

relationship
object

The app's publication relationship and custom connections.

Code Example

Revert App
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"
# Required query arguments
export version="2"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/revert?version=${version}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"