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

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)