# libtmux.Session.rename_session

- **Module:** libtmux.Session
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/036c521c4b83ce6e434eb50afe2a0d08a6a05e46/src/libtmux/session.py#L764
- **Page:** https://libtmux.org/reference/py/libtmux-session-rename_session/

```
libtmux.Session.rename_session(self, new_name: str) -> Session
```

Rename session and return new :class:`Session` object.

## Parameters

- `self`
- `new_name` (str) — new session name

## Raises

- `exc.BadSessionName`