> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd rename

> Rename an issue ID

Generated from `bd help --doc rename`.

Rename an issue from one ID to another.

This updates:

* The issue's primary ID
* All references in other issues (descriptions, titles, notes, etc.)
* Dependencies pointing to/from this issue
* Labels, comments, and events

Examples:
bd rename bd-w382l bd-dolt     # Rename to memorable ID
bd rename gt-abc123 gt-auth    # Use descriptive ID

Note: The new ID must use a valid prefix for this database.

```
bd rename <old-id> <new-id> [flags]
```