# MD_UPDATE_DIVE_METADATA
> Update a Dive's title or description without creating a new version.
Updates the title and/or description of an existing [Dive](/key-tasks/ai-and-motherduck/dives). This does not create an additional version—only the metadata is changed.

## Syntax

```sql
SELECT * FROM MD_UPDATE_DIVE_METADATA(
  id ='your-dive-uuid'::UUID,
  title ='New Title',
  description ='New description'
);
```

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | `UUID` | Yes | The unique identifier of the Dive to update |
| `title` | `VARCHAR` | No | New title for the Dive |
| `description` | `VARCHAR` | No | New description for the Dive |

At least one of `title` or `description` should be provided.

## Return columns

| Column | Type | Description |
|--------|------|-------------|
| `id` | `UUID` | Unique identifier of the Dive |
| `title` | `VARCHAR` | Updated Dive title |
| `description` | `VARCHAR` | Updated Dive description |
| `owner_id` | `UUID` | UUID of the Dive owner |
| `current_version` | `INTEGER` | Current version number (unchanged) |
| `created_at` | `TIMESTAMP WITH TIME ZONE` | When the Dive was created |
| `updated_at` | `TIMESTAMP WITH TIME ZONE` | When the Dive was last updated |
| `owner_name` | `VARCHAR` | Name of the Dive owner |

## Examples

Update a Dive's title:

```sql
SELECT id, title, updated_at
FROM MD_UPDATE_DIVE_METADATA(
  id ='a1b2c3d4-e5f6-7890-abcd-ef1234567890'::UUID,
  title ='Q1 Revenue Dashboard'
);
```

Update both title and description:

```sql
SELECT *
FROM MD_UPDATE_DIVE_METADATA(
  id ='a1b2c3d4-e5f6-7890-abcd-ef1234567890'::UUID,
  title ='Q1 Revenue Dashboard',
  description ='Revenue breakdown by region for Q1 2025'
);
```

## Errors

Returns an error if the Dive does not exist.

## Related

- [`MD_UPDATE_DIVE_CONTENT`](../md-update-dive-content) — Update a Dive's content (creates an additional version)
- [`update_dive` MCP tool](/sql-reference/mcp/update-dive) — 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%2Fai-functions%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.