---
title: "Remove app from a draft"
method: DELETE
path: "/v2/documents/{documentId}/draft/{draftId}/app"
tags: ["Apps"]
---

# Remove app from a draft

`DELETE /v2/documents/{documentId}/draft/{draftId}/app`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v2/documents/{documentId}/draft/{draftId}/app`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

<Note>
  This API is currently in development and may change.
</Note>

Remove the app from an existing draft. Use the `draftIdentifier` in the response to call the [Publish draft API](/api/documents-v2/publish-draft) and publish the changes.

## Path parameters

- `draftId` string, required
- `documentId` string, required

## Response `200`

App removed on the draft.

- DocumentsV2PatchDraftResponse
  - `identifier` string, required: Published document identifier the draft targets.
  - `draftIdentifier` string, required: Identifier of the draft the patch was applied to.
  - `name` string, required: Document name.
  - `description` string, nullable, required: Document description.

## Other responses

- `401`: Authentication required.
- `403`: Insufficient permissions: no write access to the document, apps not enabled for the organization, or (user-scoped keys) the role does not allow creating apps.
- `404`: Document or draft not found. Also returned when `documentId` names a draft rather than a published document — drafts only attach to published documents.
- `405`: Method not allowed.
- `422`: The draft is a dashboard, not an app; there is no app to remove.

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v2/documents/:documentId/draft/:draftId/app/delete.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)