2019-11-16 22:32:05 +02:00
# setChatDescription
## Description
Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success.
## Arguments
| Name | Type | Description |
| - | - | - |
| `chat_id` | `#!python3 Union[int, str]` | Unique identifier for the target chat or username of the target channel (in the format @channelusername ) |
| `description` | `#!python3 Optional[str]` | Optional. New chat description, 0-255 characters |
## Response
Type: `#!python3 bool`
Description: Returns True on success.
## Usage
### As bot method bot
```python3
result: bool = await bot.set_chat_description(...)
```
### Method as object
Imports:
2019-12-11 16:52:21 +02:00
- `from aiogram.methods import SetChatDescription`
- `from aiogram.api.methods import SetChatDescription`
- `from aiogram.api.methods.set_chat_description import SetChatDescription`
2019-11-16 22:32:05 +02:00
2020-01-11 22:59:14 +02:00
#### In handlers with current bot
2019-11-16 22:32:05 +02:00
```python3
2020-01-11 22:59:14 +02:00
result: bool = await SetChatDescription(...)
2019-11-16 22:32:05 +02:00
```
#### With specific bot
```python3
2020-01-11 22:59:14 +02:00
result: bool = await bot(SetChatDescription(...))
2019-11-16 22:32:05 +02:00
```
2020-01-11 22:59:14 +02:00
#### As reply into Webhook in handler
2019-11-16 22:32:05 +02:00
```python3
2020-01-11 22:59:14 +02:00
return SetChatDescription(...)
2019-11-16 22:32:05 +02:00
```
2020-01-11 22:59:14 +02:00
2019-11-16 22:32:05 +02:00
## Related pages:
- [Official documentation ](https://core.telegram.org/bots/api#setchatdescription )