Lists the administrators of a group or channel.
Request
method is "getChatAdministrators".
| Field |
Type |
Required |
Description |
chat_id |
String |
Yes |
The group or channel to list administrators for. |
app_id |
String |
Yes |
The app the chat belongs to. |
reference |
String |
Optional |
Your id for this request. Echoed back in the response. |
Preconditions
| Requirement |
Why |
"Manage Chats" permission |
Needed to read chat membership. |
| Moderator or admin in the chat |
The administrator list is only visible to privileged roles. |
Response
chatAdministrators
| Field |
Type |
Returned |
Description |
method |
String |
Yes |
"chatAdministrators" |
chatAdministrators |
Chat Administrators |
Yes |
Holds the chat and an administrators array of user ids. |
app_id |
String |
Yes |
Echoed from the request. |
reference |
String |
Optional |
Echoed from the request. |
SDKs
| SDK |
Call |
Callback |
| Java |
api.getChatAdministrators(chatId, appId, reference); |
onChatAdministrators(ChatAdministrators chatAdministrators) |
| JavaScript |
api.getChatAdministrators(chatId, appId, reference); |
onChatAdministrators(chatAdministrators) |
| Python |
napi.get_chat_administrators(chat_id=chat_id, app_id=app_id, reference=reference) |
on_chat_administrators(self, chat_administrators) |
Example
Request
{
"method": "getChatAdministrators",
"chat_id": "90090684270838031",
"app_id": "90090684293000559",
"reference": "123456789"
}
api.getChatAdministrators("90090684270838031", "90090684293000559", "123456789");
api.getChatAdministrators("90090684270838031", "90090684293000559", "123456789");
napi.get_chat_administrators(chat_id="90090684270838031", app_id="90090684293000559", reference="123456789")
Response
{
"method": "chatAdministrators",
"app_id": "90090684293000559",
"reference": "123456789",
"chatAdministrators": {
"chat": {
"id": "90090684270838031"
},
"administrators": [
{ "id": "90091783822039252" },
{ "id": "90092883286353982" }
]
}
}