# libtmux.Session.rename_session

- **Module:** libtmux.Session
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/9fdd083a8181a827889337b63cd4e6daea661a8c/src/libtmux/session.py#L764
- **Page:** https://libtmux.org/en/py/latest/reference/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`