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/create-publish-request.md. A documentation index is available at /llms.txt.
Language
Datadog site
CAUTIONThis product is not supported for your selected Datadog site. (US2-FED).

Create Publish Request

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

Overview

Create a publish request to ask for approval to publish an app whose protection level is approval_required. Publishing happens automatically once the request is approved by a user with the appropriate permissions.

This endpoint requires the apps_write permission.

Arguments

Path Parameters

Name
Type
Description
app_id [required]
string

The ID of the app.

Request

Body Data (required)

Field
Type
Description
data
object

Data for creating a publish request.

Response

Created

The response object after an app is successfully published.

Field
Type
Description
data
object

The version of the app that was published.

Code Example

Create Publish Request
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# 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}/publish-request" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "Adds new dashboard widgets and a few bug fixes.",
      "title": "Release v1.2 to production"
    },
    "type": "publishRequest"
  }
}
EOF