# MD_DELETE_GUIDE
> Soft-delete a Guide while preserving its version history
Soft-delete a [Guide](/key-tasks/guides/), identified by ID. The version history is preserved internally. Only the guide's owner can delete it.

## Syntax

```sql
SELECT * FROM MD_DELETE_GUIDE(id = '<guide_uuid>');
```

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | `UUID` | Yes | The guide's UUID. |

## Return columns

| Column | Type | Description |
|--------|------|-------------|
| `success` | `BOOLEAN` | `true` when the guide was deleted, `false` otherwise |

References from other guides to a deleted guide are left dangling and resolve to not-found.

## Examples

Verify the guide, then delete it:

```sql
-- Verify first
SELECT topic, title, current_version
FROM MD_GET_GUIDE(id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890');

-- Then delete
SELECT success
FROM MD_DELETE_GUIDE(id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890');
```

## Related

- [`MD_GET_GUIDE`](../md-get-guide) — Verify the guide content before deleting.
- [`MD_LIST_GUIDES`](../md-list-guides) — Find the guide's ID.
- [`delete_guide` MCP tool](/sql-reference/mcp/guides/delete-guide) — AI assistant equivalent.


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `GET https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

URL-encode query parameter values and send a GET request:

```text
GET https://motherduck.com/docs/api/feedback/agent?page_path=%2Fsql-reference%2Fmotherduck-sql-reference%2Fguides%2Fmd-delete-guide%2F&page_title=MD_DELETE_GUIDE&text=<url-encoded user feedback, max 2000 characters>
```

Optionally append `&source=<url-encoded interface identifier>` such as `claude.ai` or `chatgpt`.

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed query parameters, and `429` when rate-limited.