---
title: "Remove dashboard from document"
method: DELETE
path: "/v2/documents/{documentId}/draft/{draftId}/dashboard"
tags: ["Documents"]
---

# Remove dashboard from document

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

Remove the dashboard from an existing draft, leaving a workbook-only document. Documents that are already workbook-only will remain unchanged.

Use the [Publish draft endpoint](/api/documents-v2/publish-draft) to apply the changes from this endpoint to the published version of the document. **Note**: Schedules will be removed when the document is published.

## Path parameters

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

## Response `200`

Dashboard removed on the draft. The response includes the `draftIdentifier`.

- 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 to update the document.
- `404` — Document or draft not found.
- `405` — Method not allowed.
- `409` — The specified document is not a published document.
- `422` — The document is an app, not a dashboard.

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)