---
title: "Unpublish App"
method: DELETE
path: "/api/v2/app-builder/apps/{app_id}/deployment"
tags: ["App Builder"]
---

# Unpublish App

`DELETE /api/v2/app-builder/apps/{app_id}/deployment`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/app-builder/apps/{app_id}/deployment`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Unpublish an app, removing the live version of the app. Unpublishing creates a new instance of a `deployment` object on the app, with a nil `app_version_id` (`00000000-0000-0000-0000-000000000000`). The app can still be updated and published again in the future. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access).

## Path parameters

- `app_id` string, uuid, required

## Response `200`

OK

- UnpublishAppResponse: The response object after an app is successfully unpublished.
  - `data` Deployment: The version of the app that was published.
    - `attributes` DeploymentAttributes: The attributes object containing the version ID of the published app.
      - `app_version_id` string, uuid: The version ID of the app that was published. For an unpublished app, this is always the nil UUID (`00000000-0000-0000-0000-000000000000`).
    - `id` string, uuid: The deployment ID.
    - `meta` DeploymentMetadata: Metadata object containing the publication creation information.
      - `created_at` string, date-time: Timestamp of when the app was published.
      - `user_id` integer: The ID of the user who published the app.
      - `user_name` string: The name (or email address) of the user who published the app.
      - `user_uuid` string, uuid: The UUID of the user who published the app.
    - `type` 'deployment': The deployment type.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)