Telegram
Commands — Telegram
Find every Telegram CLI command, argument, option and exit code in the generated command reference.
Choose the reference for your task. Start with First tasks if you're getting acquainted; use this reference for exact commands, arguments and options. First tasks →
Personal accountChats, messages, contacts, search, files, sending and auto-replies in your own account.
BotsBot connection, messages, updates and the full Bot API.
Group and channel administrationMembers, invitations, permissions, moderation, forum topics and statistics for groups and channels. Changes require the relevant permissions.
Setup and maintenanceLogin, profiles, configuration, the background server, the local store, diagnostics, agent connection and updates.
Find a command by name
- tg session
- tg session start
- tg session end
- tg setup
- tg account
- tg account list
- tg account show
- tg account update
- tg account sessions
- tg account sessions list
- tg account sessions end
- tg account remove
- tg chats
- tg chats list
- tg chats events
- tg chats inspect
- tg chats show
- tg chats send-as
- tg chats documents
- tg chats documents list
- tg chats members
- tg chats members list
- tg chats members check
- tg chats members history
- tg chats members fetch
- tg chats members add
- tg chats members remove
- tg chats mark-read
- tg chats tracking
- tg chats tracking list
- tg chats tracking show
- tg chats tracking add
- tg chats tracking remove
- tg chats create
- tg chats join
- tg chats leave
- tg chats update
- tg chats links
- tg chats links show
- tg chats links create
- tg chats links list
- tg chats links remove
- tg chats links update
- tg chats links reset
- tg chats requests
- tg chats requests list
- tg chats requests confirm
- tg chats requests reject
- tg chats admins
- tg chats admins add
- tg chats admins remove
- tg chats folders
- tg chats folders list
- tg chats folders show
- tg chats folders create
- tg chats folders update
- tg chats folders delete
- tg chats folders order
- tg chats folders join
- tg chats rules
- tg chats rules show
- tg chats rules set
- tg chats rules unset
- tg chats moderate
- tg chats mute
- tg chats unmute
- tg chats archive
- tg chats unarchive
- tg chats pin
- tg chats unpin
- tg chats mark-unread
- tg chats start
- tg chats app
- tg contacts
- tg contacts list
- tg contacts show
- tg contacts context
- tg contacts prepare
- tg contacts events
- tg contacts check
- tg contacts link
- tg contacts unlink
- tg contacts lookup
- tg contacts sync
- tg contacts aliases
- tg contacts aliases set
- tg contacts aliases remove
- tg contacts notes
- tg contacts notes list
- tg contacts notes show
- tg contacts notes add
- tg contacts notes edit
- tg contacts notes remove
- tg contacts add
- tg contacts remove
- tg contacts block
- tg contacts unblock
- tg contacts rename
- tg contacts import
- tg messages
- tg messages evidence
- tg messages list
- tg messages send
- tg messages show
- tg messages context
- tg messages download
- tg messages transcribe
- tg messages edit
- tg messages delete
- tg messages forward
- tg messages pin
- tg messages unpin
- tg messages press
- tg messages scheduled
- tg messages link
- tg messages comments
- tg messages links
- tg messages sync
- tg reactions
- tg reactions list
- tg reactions add
- tg reactions remove
- tg polls
- tg polls show
- tg polls voters
- tg polls vote
- tg polls close
- tg polls create
- tg models
- tg models keys
- tg models keys set
- tg models keys remove
- tg models list
- tg models download
- tg models set
- tg models add
- tg inbox
- tg review
- tg topics
- tg topics list
- tg topics show
- tg topics icons
- tg topics icons list
- tg topics enable
- tg topics create
- tg topics edit
- tg topics delete
- tg topics order
- tg watch
- tg serve
- tg server
- tg server start
- tg server stop
- tg server restart
- tg server status
- tg server logs
- tg server install
- tg server uninstall
- tg schedule
- tg schedule command
- tg schedule agent
- tg schedule list
- tg schedule run
- tg schedule remove
- tg schedule pause
- tg schedule resume
- tg schedule exec
- tg store
- tg store status
- tg store chats
- tg store chats status
- tg store gaps
- tg store gaps show
- tg store gaps repair
- tg store jobs
- tg store jobs list
- tg store jobs show
- tg store jobs cancel
- tg store jobs retry
- tg store jobs clear
- tg store export
- tg store clear
- tg store import
- tg store info
- tg store check
- tg store migrate
- tg store rebuild
- tg store backup
- tg store restore
- tg store decrypt
- tg store repair
- tg store reset
- tg store copies
- tg store copies delete
- tg store tables
- tg store tables list
- tg store recover
- tg store recover run
- tg conversations
- tg conversations list
- tg conversations show
- tg conversations related
- tg conversations status
- tg conversations batches
- tg conversations batches status
- tg conversations batches show
- tg conversations links
- tg conversations links rebuild
- tg conversations links add
- tg conversations links clear
- tg conversations embeddings
- tg conversations embeddings status
- tg conversations embeddings clear
- tg conversations rebuild
- tg conversations consents
- tg conversations consents list
- tg conversations consents remove
- tg conversations embed
- tg attachments
- tg attachments extract
- tg attachments list
- tg attachments show
- tg attachments update
- tg attachments download
- tg attachments check
- tg attachments jobs
- tg attachments jobs install
- tg attachments jobs start
- tg attachments jobs stop
- tg attachments jobs status
- tg attachments jobs uninstall
- tg attachments move
- tg tags
- tg tags rebuild
- tg tags add
- tg tags remove
- tg tags list
- tg mentions
- tg mentions list
- tg mentions domains
- tg mentions places
- tg mentions show
- tg mentions confirm
- tg mentions reject
- tg mentions rebuild
- tg images
- tg images embed
- tg images models
- tg images models list
- tg images models download
- tg metadata
- tg metadata show
- tg metadata sync
- tg stats
- tg stats messages
- tg stats messages show
- tg stats messages counters
- tg stats messages counters show
- tg stats messages counters sync
- tg stats messages unanswered
- tg stats messages discussion
- tg stats messages responses
- tg stats messages waiting
- tg stats messages top
- tg stats messages evidence
- tg stats contacts
- tg stats contacts responses
- tg stats contacts top
- tg stats contacts evidence
- tg stats chats
- tg stats chats show
- tg stats chats newcomers
- tg stats chats retention
- tg stats chats official
- tg stats tasks
- tg stats tasks show
- tg stats charts
- tg tasks
- tg tasks list
- tg tasks add
- tg tasks update
- tg tasks link
- tg tasks show
- tg tasks related
- tg tasks duplicates
- tg tasks duplicates list
- tg tasks duplicates reject
- tg tasks duplicates defer
- tg tasks merge
- tg tasks unmerge
- tg tasks agenda
- tg tasks categories
- tg tasks scan
- tg tasks status
- tg tasks review
- tg tasks acknowledge
- tg tasks claim
- tg tasks release
- tg tasks close
- tg tasks reject
- tg projects
- tg projects evidence
- tg projects status
- tg search
- tg search all
- tg search messages
- tg search notes
- tg search conversations
- tg search runs
- tg search topics
- tg searches
- tg searches create
- tg searches show
- tg searches list
- tg searches history
- tg searches delete
- tg searches clear
- tg flood
- tg flood clear
- tg replies
- tg replies add
- tg replies on
- tg replies off
- tg replies edit
- tg replies audience
- tg replies consents
- tg replies consents show
- tg replies consents grant
- tg replies consents revoke
- tg replies consents deny
- tg replies consents allow
- tg replies test
- tg replies pause
- tg replies resume
- tg replies status
- tg recipients
- tg recipients list
- tg recipients add
- tg recipients remove
- tg recipients clear
- tg sends
- tg sends list
- tg runs
- tg runs list
- tg runs show
- tg runs path
- tg config
- tg config show
- tg config set
- tg config unset
- tg config migrate
- tg config repair
- tg doctor
- tg doctor reports
- tg doctor reports show
- tg doctor reports create
- tg commands
- tg commands info
- tg complete
- tg upgrade
- tg mcp
- tg mcp serve
- tg mcp revoke
- tg mcp server
- tg mcp server start
- tg mcp server stop
- tg mcp server status
- tg mcp config
- tg mcp add
- tg mcp check
- tg bot
- tg bot auth
- tg bot auth set
- tg bot auth show
- tg bot auth remove
- tg bot list
- tg bot chats
- tg bot chats list
- tg bot chats show
- tg bot chats leave
- tg bot chats action
- tg bot chats admins
- tg bot chats admins list
- tg bot chats admins add
- tg bot chats admins remove
- tg bot chats members
- tg bot chats members remove
- tg bot chats rules
- tg bot chats rules show
- tg bot chats rules set
- tg bot chats rules unset
- tg bot chats moderate
- tg bot messages
- tg bot messages send
- tg bot messages list
- tg bot messages show
- tg bot messages edit
- tg bot messages delete
- tg bot messages pin
- tg bot messages unpin
- tg bot messages between
- tg bot messages sync
- tg bot search
- tg bot search messages
- tg bot recipients
- tg bot recipients list
- tg bot recipients add
- tg bot recipients remove
- tg bot recipients clear
- tg bot sends
- tg bot sends list
- tg bot watch
- tg bot callbacks
- tg bot callbacks answer
- tg bot commands
- tg bot commands list
- tg bot commands set
- tg bot commands clear
- tg bot webhooks
- tg bot webhooks list
- tg bot webhooks set
- tg bot webhooks delete
- tg bot contacts
- tg bot contacts show
- tg bot me
- tg bot mcp
- tg bot mcp serve
- tg bot mcp config
- tg bot api
- tg bot api get-updates
- tg bot api set-webhook
- tg bot api delete-webhook
- tg bot api get-webhook-info
- tg bot api get-me
- tg bot api log-out
- tg bot api close
- tg bot api send-message
- tg bot api forward-message
- tg bot api forward-messages
- tg bot api copy-message
- tg bot api copy-messages
- tg bot api send-photo
- tg bot api send-live-photo
- tg bot api send-audio
- tg bot api send-document
- tg bot api send-video
- tg bot api send-animation
- tg bot api send-voice
- tg bot api send-video-note
- tg bot api send-paid-media
- tg bot api send-media-group
- tg bot api send-location
- tg bot api send-venue
- tg bot api send-contact
- tg bot api send-poll
- tg bot api send-checklist
- tg bot api send-dice
- tg bot api send-message-draft
- tg bot api send-chat-action
- tg bot api set-message-reaction
- tg bot api get-user-profile-photos
- tg bot api get-user-profile-audios
- tg bot api set-user-emoji-status
- tg bot api get-file
- tg bot api ban-chat-member
- tg bot api unban-chat-member
- tg bot api restrict-chat-member
- tg bot api promote-chat-member
- tg bot api set-chat-administrator-custom-title
- tg bot api set-chat-member-tag
- tg bot api ban-chat-sender-chat
- tg bot api unban-chat-sender-chat
- tg bot api set-chat-permissions
- tg bot api export-chat-invite-link
- tg bot api create-chat-invite-link
- tg bot api edit-chat-invite-link
- tg bot api create-chat-subscription-invite-link
- tg bot api edit-chat-subscription-invite-link
- tg bot api revoke-chat-invite-link
- tg bot api approve-chat-join-request
- tg bot api decline-chat-join-request
- tg bot api answer-chat-join-request-query
- tg bot api send-chat-join-request-web-app
- tg bot api set-chat-photo
- tg bot api delete-chat-photo
- tg bot api set-chat-title
- tg bot api set-chat-description
- tg bot api pin-chat-message
- tg bot api unpin-chat-message
- tg bot api unpin-all-chat-messages
- tg bot api leave-chat
- tg bot api get-chat
- tg bot api get-chat-administrators
- tg bot api get-chat-member-count
- tg bot api get-chat-member
- tg bot api get-user-personal-chat-messages
- tg bot api set-chat-sticker-set
- tg bot api delete-chat-sticker-set
- tg bot api get-forum-topic-icon-stickers
- tg bot api create-forum-topic
- tg bot api edit-forum-topic
- tg bot api close-forum-topic
- tg bot api reopen-forum-topic
- tg bot api delete-forum-topic
- tg bot api unpin-all-forum-topic-messages
- tg bot api edit-general-forum-topic
- tg bot api close-general-forum-topic
- tg bot api reopen-general-forum-topic
- tg bot api hide-general-forum-topic
- tg bot api unhide-general-forum-topic
- tg bot api unpin-all-general-forum-topic-messages
- tg bot api answer-callback-query
- tg bot api answer-guest-query
- tg bot api get-user-chat-boosts
- tg bot api get-business-connection
- tg bot api get-managed-bot-token
- tg bot api replace-managed-bot-token
- tg bot api get-managed-bot-access-settings
- tg bot api set-managed-bot-access-settings
- tg bot api set-my-commands
- tg bot api delete-my-commands
- tg bot api get-my-commands
- tg bot api set-my-name
- tg bot api get-my-name
- tg bot api set-my-description
- tg bot api get-my-description
- tg bot api set-my-short-description
- tg bot api get-my-short-description
- tg bot api set-my-profile-photo
- tg bot api remove-my-profile-photo
- tg bot api set-chat-menu-button
- tg bot api get-chat-menu-button
- tg bot api set-my-default-administrator-rights
- tg bot api get-my-default-administrator-rights
- tg bot api get-available-gifts
- tg bot api send-gift
- tg bot api gift-premium-subscription
- tg bot api verify-user
- tg bot api verify-chat
- tg bot api remove-user-verification
- tg bot api remove-chat-verification
- tg bot api read-business-message
- tg bot api delete-business-messages
- tg bot api set-business-account-name
- tg bot api set-business-account-username
- tg bot api set-business-account-bio
- tg bot api set-business-account-profile-photo
- tg bot api remove-business-account-profile-photo
- tg bot api set-business-account-gift-settings
- tg bot api get-business-account-star-balance
- tg bot api transfer-business-account-stars
- tg bot api get-business-account-gifts
- tg bot api get-user-gifts
- tg bot api get-chat-gifts
- tg bot api convert-gift-to-stars
- tg bot api upgrade-gift
- tg bot api transfer-gift
- tg bot api post-story
- tg bot api repost-story
- tg bot api edit-story
- tg bot api delete-story
- tg bot api answer-web-app-query
- tg bot api save-prepared-inline-message
- tg bot api save-prepared-keyboard-button
- tg bot api edit-message-text
- tg bot api edit-message-caption
- tg bot api edit-message-media
- tg bot api edit-message-live-location
- tg bot api stop-message-live-location
- tg bot api edit-message-checklist
- tg bot api edit-message-reply-markup
- tg bot api stop-poll
- tg bot api edit-ephemeral-message-text
- tg bot api edit-ephemeral-message-media
- tg bot api edit-ephemeral-message-caption
- tg bot api edit-ephemeral-message-reply-markup
- tg bot api approve-suggested-post
- tg bot api decline-suggested-post
- tg bot api delete-message
- tg bot api delete-messages
- tg bot api delete-ephemeral-message
- tg bot api delete-message-reaction
- tg bot api delete-all-message-reactions
- tg bot api send-sticker
- tg bot api get-sticker-set
- tg bot api get-custom-emoji-stickers
- tg bot api upload-sticker-file
- tg bot api create-new-sticker-set
- tg bot api add-sticker-to-set
- tg bot api set-sticker-position-in-set
- tg bot api delete-sticker-from-set
- tg bot api replace-sticker-in-set
- tg bot api set-sticker-emoji-list
- tg bot api set-sticker-keywords
- tg bot api set-sticker-mask-position
- tg bot api set-sticker-set-title
- tg bot api set-sticker-set-thumbnail
- tg bot api set-custom-emoji-sticker-set-thumbnail
- tg bot api delete-sticker-set
- tg bot api send-rich-message
- tg bot api send-rich-message-draft
- tg bot api answer-inline-query
- tg bot api send-invoice
- tg bot api create-invoice-link
- tg bot api answer-shipping-query
- tg bot api answer-pre-checkout-query
- tg bot api get-my-star-balance
- tg bot api get-star-transactions
- tg bot api refund-star-payment
- tg bot api edit-user-star-subscription
- tg bot api set-passport-data-errors
- tg bot api send-game
- tg bot api set-game-score
- tg bot api get-game-high-scores
- tg skill
- tg skill show
- tg skill install
- tg skill status
- tg guide
How commands work
tg [profile] [options] <resource> <action> [arguments]- Resource first, then the action. The resource is what you work with:
chats,messages,contacts. The action is what you do with it:list,show,send. - Name the profile as the first word:
tg work chats listlists the chats of profilework. No profile is ever assumed: a command that needs an account and gets none from the first word orTG_PROFILEstops and lists your profiles, even when there is only one. - Global options work with every command:
--jsonfor scripts and agents,--dry-runto check a command without running it,--offlineto answer from the local copy only. - A command that changes something is marked in the reference: “Changes something in Telegram” changes data in the messenger, “Changes something on this computer only” changes only files on this computer.
- Permission levels can make a write ask for confirmation first.
--yesgives that confirmation in advance. - Each reference ends with the exit codes.
tg commandslists every command by section and marks the ones that change something;tg guidelists step-by-step scenarios. Options are intg commands --jsonandtg <command> --help.