# MD_UPDATE_DIVE_METADATA
> Update a Dive's title or description without creating a new version.
Updates the title, description, or both of an existing [Dive](/key-tasks/ai-and-motherduck/dives). Metadata updates do not create a new version — `current_version` is unchanged. To publish new component code, use [`MD_UPDATE_DIVE_CONTENT`](../md-update-dive-content).

## Syntax

```sql
SELECT * FROM MD_UPDATE_DIVE_METADATA(
    id := '<dive_id>',
    title := '<updated_title>',
    description := '<updated_description>'
);
```

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `id` | `UUID` | Yes | Identifier of the Dive to update. |
| `title` | `VARCHAR` | No | New Dive title. Omit to leave unchanged. |
| `description` | `VARCHAR` | No | New Dive description. Omit to leave unchanged. |

## Return columns

Returns the updated Dive summary:

| Column | Type | Description |
|---|---|---|
| `id` | `UUID` | The Dive identifier. |
| `title` | `VARCHAR` | The current title. |
| `description` | `VARCHAR` | The current description, or `NULL`. |
| `owner_id` | `UUID` | Identifier of the owning user. |
| `current_version` | `INTEGER` | Latest version number (unchanged by this call). |
| `created_at` | `TIMESTAMP WITH TIME ZONE` | Original creation timestamp. |
| `updated_at` | `TIMESTAMP WITH TIME ZONE` | Most recent update timestamp. |
| `owner_name` | `VARCHAR` | Username of the owner. |

## Examples

Rename a Dive:

```sql
SELECT id, title, current_version
FROM MD_UPDATE_DIVE_METADATA(
    id := '<dive_id>',
    title := 'Q1 revenue dashboard'
);
```

Update only the description:

```sql
SELECT id, description
FROM MD_UPDATE_DIVE_METADATA(
    id := '<dive_id>',
    description := 'Revenue trends filtered to Q1'
);
```

## Related

- [`MD_UPDATE_DIVE_CONTENT`](../md-update-dive-content) — Publish new component code as a new version.
- [`MD_GET_DIVE`](../md-get-dive) — Inspect the current summary and content.
- [`update_dive` MCP tool](/sql-reference/mcp/dives/update-dive) — AI-agent 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%2Fdives%2Fmd-update-dive-metadata%2F&page_title=MD_UPDATE_DIVE_METADATA&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.