---
title: document_delete
description: Delete a file attached to a brand, along with its stored bytes.
---

Deletes a **document** and the bytes behind it. Its URL stops resolving.

## Input

| Field         | Type     | Required | Description                       |
| ------------- | -------- | -------- | --------------------------------- |
| `document_id` | `string` | yes      | The id of the document to delete. |

## Output

`{ deleted: true, documentId }`.

:::warning[Deleting a brand takes its documents too]

Removing a brand with [`brand_delete`](/mcp/tools/brand-delete) also removes every document attached to it. You don't need to clear them first.

:::

Requires the `brand:write` scope.