telegram api method · layer 229 · #a0f4cb4f
messages.getDialogs
Returns the current user dialog list.
definition
messages.getDialogs#a0f4cb4f flags:# exclude_pinned:flags.0?true folder_id:flags.1?int offset_date:int offset_id:int offset_peer:InputPeer limit:int hash:long = messages.Dialogs;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
exclude_pinned | true | Exclude pinned dialogs |
folder_id | int | Peer folder ID, for more info click here |
offset_date | int | Offsets for pagination, for more info click here |
offset_id | int | Offsets for pagination, for more info click here (top_message ID used for pagination) |
offset_peer | InputPeer | Offset peer for pagination |
limit | int | Number of list elements to be returned |
hash | long | Hash used for caching, for more info click here |
returns
errors (8)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | CHAT_NOT_MODIFIED | No changes were made to chat information because the new information you passed is identical to the current information. |
| 400 | FOLDER_ID_INVALID | Invalid folder ID. |
| 400 | OFFSET_PEER_ID_INVALID | The provided offset peer is invalid. |
| 400 | PINNED_DIALOGS_TOO_MUCH | Too many pinned dialogs. |
| 400 | TAKEOUT_INVALID | The specified takeout ID is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
history
present in layers 2–229 · constructor id changed 6×
| id | layers |
|---|---|
| #eccf1df6 | 2–23 |
| #6b47f94d | 46 |
| #191ba9c5 | 62–74 |
| #05c0fae2 | 75 |
| #191ba9c5 | 76 |
| #05c0fae2 | 77 |
| #191ba9c5 | 78–81 |
| #b098aee6 | 82–98 |
| #a0ee3b73 | 99–132 |
| #a0f4cb4f | 133–229 |