Reyta Bot API

Build chat bots on Reyta over a simple HTTPS API. It mirrors the Telegram Bot API, so the methods, parameters, and JSON responses you already know work here unchanged – and an existing bot moves over by changing one line.

Introduction

The Bot API is a set of HTTPS endpoints. Each call is the base URL, then your bot token, then a method name. You send parameters; you get back JSON. There is nothing else to install on the server side – any language with an HTTP client can talk to it.

Endpoint shape

https://api.reyta.uz/bot<token>/METHOD_NAME

Every response has the same envelope: a boolean ok, and either a result on success or an error_code plus a human-readable description on failure.

Response envelope

{ "ok": true,  "result": { ... } }
{ "ok": false, "error_code": 401, "description": "Unauthorized" }

Get a token by creating a bot with BotMother. That token is the only credential you need – treat it like a password.

Quick start

Call getMe to confirm your token and see your bot. Paste this into a terminal (replace <token>):

Request

curl "https://api.reyta.uz/bot<token>/getMe"

Response

{
  "ok": true,
  "result": {
    "id": 770001,
    "is_bot": true,
    "first_name": "My Bot",
    "username": "my_bot"
  }
}

That is the whole model: swap getMe for any method below, add its parameters, and read the JSON back.

Authorization

The token goes directly in the request path – there is no separate header or OAuth step. Keep it secret: anyone who has it can control the bot. If it leaks, revoke and reissue it in BotMother.

Verify a token

curl "https://api.reyta.uz/bot<token>/getMe"

Making requests

Send parameters as a query string, form-encoded body (application/x-www-form-urlencoded), or JSON (application/json). To upload a file, use multipart/form-data. Both GET and POST work for most methods.

Request with JSON body

curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 987654321, "text": "Hello from Reyta"}'

Migrate from Telegram

Because the surface matches the Telegram Bot API, migration is not a rewrite – it is a configuration change. Point your library’s API root at Reyta and use a token from BotMother. Your method calls, update handling, and types stay exactly the same. Here are the one-line changes for popular libraries (grammY and Telegraf are verified against this endpoint).

grammY (Node / TypeScript)

grammy.ts

import { Bot } from "grammy";

const bot = new Bot("<token>", {
  client: { apiRoot: "https://api.reyta.uz" },
});

console.log(await bot.api.getMe());

Telegraf (Node / TypeScript)

telegraf.ts

import { Telegraf } from "telegraf";

const bot = new Telegraf("<token>", {
  telegram: { apiRoot: "https://api.reyta.uz" },
});

console.log(await bot.telegram.getMe());

python-telegram-bot

bot.py

from telegram.ext import ApplicationBuilder

app = (
    ApplicationBuilder()
    .token("<token>")
    .base_url("https://api.reyta.uz/bot")
    .build()
)

Any other library or raw HTTP

If your library exposes an API base URL, host, or apiRoot option, set it to https://api.reyta.uz. If you call the API directly, just change the host:

Base URL

- https://api.telegram.org/bot<token>/sendMessage
+ https://api.reyta.uz/bot<token>/sendMessage

Send a message

To message a user or chat you need its chat_id. The simplest way to get one: send your bot a message, then read it back with getUpdates – the chat.id is in the response. Then:

sendMessage

curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -d "chat_id=987654321" \
  -d "text=Salom! My bot is live on Reyta." \
  -d "parse_mode=HTML"

Add an inline keyboard, reply to a message, or attach media with the parameters listed under each method below.

Getting updates

Receive incoming events by long polling or webhook. Pick one – they are mutually exclusive.

POST/bot<token>/getUpdates→ Array of Update

Poll for new updates using long polling. Returns an array of Update objects.

Parameter	Type	Required	Description
`offset`	Integer	Optional	Identifier of the first update to return. Set to last received update_id + 1 to confirm.
`limit`	Integer	Optional	Number of updates to retrieve, 1–100. Default 100.
`timeout`	Integer	Optional	Long-polling timeout in seconds. 0 for short polling (testing only).
`allowed_updates`	Array of String	Optional	List of update types to receive, e.g. ["message","callback_query"].

Request

curl "https://api.reyta.uz/bot<token>/getUpdates" \
  -d "timeout=30&offset=1"

Response

{
  "ok": true,
  "result": [
    {
      "update_id": 100001,
      "message": {
        "message_id": 42,
        "from": { "id": 987654321, "is_bot": false, "first_name": "Aziz" },
        "chat": { "id": 987654321, "type": "private" },
        "date": 1783900000,
        "text": "/start"
      }
    }
  ]
}

POST/bot<token>/setWebhook→ True

Parameter	Type	Required	Description
`url`	String	Yes	HTTPS URL to send updates to. An empty string removes the webhook.
`secret_token`	String	Optional	1–256 chars; echoed back in the X-Telegram-Bot-Api-Secret-Token header so you can verify requests.
`allowed_updates`	Array of String	Optional	Update types to receive.
`max_connections`	Integer	Optional	Max simultaneous HTTPS connections for delivery, 1–100. Default 40.

Request

curl "https://api.reyta.uz/bot<token>/setWebhook" \
  -d "url=https://your-bot.example/hook&secret_token=s3cr3t"

Response

{ "ok": true, "result": true, "description": "Webhook was set" }

POST/bot<token>/deleteWebhook→ True

Remove the webhook and switch back to getUpdates.

GET/bot<token>/getWebhookInfo→ WebhookInfo

Current webhook status, pending update count, and last error.

Sending messages

Deliver text, media, and everyday content to any chat the bot can reach.

POST/bot<token>/sendMessage→ Message

Send a text message. Supports Markdown/HTML formatting and inline keyboards.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique chat identifier or @username of a channel.
`text`	String	Yes	Message text, 1–4096 characters.
`parse_mode`	String	Optional	"MarkdownV2" or "HTML" for entity formatting.
`reply_markup`	Object	Optional	Inline keyboard, reply keyboard, or force-reply.
`disable_notification`	Boolean	Optional	Send silently, without a notification sound.

Request

curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -d "chat_id=987654321" \
  -d "text=Salom! Reyta Bot API is live." \
  -d "parse_mode=HTML"

Response

{
  "ok": true,
  "result": {
    "message_id": 43,
    "chat": { "id": 987654321, "type": "private" },
    "date": 1783900050,
    "text": "Salom! Reyta Bot API is live."
  }
}

POST/bot<token>/sendPhoto→ Message

Send a photo by file_id, HTTP URL, or multipart upload.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat.
`photo`	String or InputFile	Yes	file_id, an HTTPS URL, or an uploaded file.
`caption`	String	Optional	Caption, 0–1024 characters.

POST/bot<token>/forwardMessage→ Message

Forward a message of any kind from one chat to another.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`from_chat_id`	Integer or String	Yes	Chat the original message comes from.
`message_id`	Integer	Yes	Identifier of the message.

POST/bot<token>/copyMessage→ MessageId

Copy a message without a forward header.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`from_chat_id`	Integer or String	Yes	Chat the original message comes from.
`message_id`	Integer	Yes	Identifier of the message.
`caption`	String	Optional	New caption. If omitted, the original caption is kept.
`parse_mode`	String	Optional	Formatting of the new caption: HTML, Markdown, or MarkdownV2.

POST/bot<token>/sendDocument→ Message

Send a general file, up to the configured size limit.

POST/bot<token>/sendVideo→ Message

Send an MP4 video.

POST/bot<token>/sendAnimation→ Message

Send a GIF or H.264/MPEG-4 animation without sound.

POST/bot<token>/sendAudio→ Message

Send an audio file to be shown in the music player.

POST/bot<token>/sendVoice→ Message

Send a voice message (OGG/OPUS).

POST/bot<token>/sendVideoNote→ Message

Send a rounded, square video note.

POST/bot<token>/sendMediaGroup→ Array of MessagePartial support

Send a group of photos/videos/documents as an album.

Returns the full array now, each item with from, date and media_group_id. The per-item media object (photo/video) is not echoed in the response yet – read the album via getUpdates if you need it.

POST/bot<token>/sendLocation→ Message

Send a point on the map; can be a live location.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`latitude`	Float	Yes	Latitude of the location.
`longitude`	Float	Yes	Longitude of the location.
`live_period`	Integer	Optional	Seconds the location stays live, 60-86400. Omit for a one-shot location.

POST/bot<token>/sendVenue→ Message

Send information about a venue.

POST/bot<token>/sendContact→ Message

Send a phone contact.

POST/bot<token>/sendPoll→ MessageNot available yet

Send a native poll or quiz.

Not implemented yet – returns 501. Polls are not supported on the server side.

POST/bot<token>/sendDice→ Message

Send an animated emoji with a random value.

POST/bot<token>/sendChatAction→ True

Show a "typing…" or "uploading…" status.

POST/bot<token>/sendSticker→ MessageNot available yet

Send a static, animated, or video sticker.

Not implemented yet – returns 501. The sticker send path lands with a later phase; retry once it does.

POST/bot<token>/copyMessages→ Array of MessageId

Copy several messages at once without a link to the original.

POST/bot<token>/forwardMessages→ Array of MessageId

Forward several messages at once, keeping the original author.

Updating & deleting

POST/bot<token>/editMessageText→ Message or TruePartial support

Edit the text of a sent or inline message.

Editing by inline_message_id is not supported yet – returns 501. Editing by chat_id + message_id works.

Parameter	Type	Required	Description
`text`	String	Yes	New text of the message.
`chat_id`	Integer or String	Optional	Target chat. Required unless inline_message_id is used.
`message_id`	Integer	Optional	Message to edit. Required unless inline_message_id is used.
`parse_mode`	String	Optional	Formatting: HTML, Markdown, or MarkdownV2.

POST/bot<token>/editMessageCaption→ Message or TruePartial support

Edit the caption of a media message.

Editing by inline_message_id is not supported yet – returns 501. Editing by chat_id + message_id works.

POST/bot<token>/editMessageMedia→ Message or TruePartial support

Replace the media of a message.

Works by chat_id + message_id (media via URL or attach:// upload; the InputMedia caption replaces the message caption). file_id reuse and inline_message_id are not supported yet.

POST/bot<token>/editMessageReplyMarkup→ Message or TruePartial support

Edit only the inline keyboard of a message.

Editing by inline_message_id is not supported yet – returns 501. Editing by chat_id + message_id works.

POST/bot<token>/editMessageLiveLocation→ Message or TruePartial support

Move an active live location.

Editing by inline_message_id is not supported yet – returns 501. Editing by chat_id + message_id works.

POST/bot<token>/deleteMessage→ True

Delete a message the bot sent, or any message where it is admin.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`message_id`	Integer	Yes	Identifier of the message.

POST/bot<token>/deleteMessages→ True

Delete multiple messages at once.

POST/bot<token>/stopMessageLiveLocation→ Message or TruePartial support

Stop updating an active live location before its period expires.

Stopping by inline_message_id is not supported yet – returns 501. Stopping by chat_id + message_id works.

POST/bot<token>/setMessageReaction→ True

Set or clear the bot's reaction on a message.

POST/bot<token>/stopPoll→ PollPartial support

Stop an active poll the bot sent.

Returns true instead of the final Poll object.

Inline & callbacks

POST/bot<token>/answerCallbackQuery→ True

Respond to an inline-button tap; optionally show an alert.

Parameter	Type	Required	Description
`callback_query_id`	String	Yes	Identifier of the callback query to answer.
`text`	String	Optional	Notification text, up to 200 characters.
`show_alert`	Boolean	Optional	Show a modal alert instead of a toast.
`url`	String	Optional	URL opened by the client.
`cache_time`	Integer	Optional	Seconds the result may be cached client-side.

POST/bot<token>/answerInlineQuery→ TruePartial support

Answer an inline query with a list of results.

Supported result types: article, photo, gif, mpeg4_gif, document. Other types return 400.

Parameter	Type	Required	Description
`inline_query_id`	String	Yes	Identifier of the inline query to answer.
`results`	Array of InlineQueryResult	Yes	JSON array of results. Supported types: article, photo, gif, mpeg4_gif, document.
`cache_time`	Integer	Optional	Seconds the result may be cached, 1-300 (default 300).
`is_personal`	Boolean	Optional	Cache the results per user instead of globally.
`next_offset`	String	Optional	Offset for the next page, up to 64 bytes.

Chats & members

Inspect and manage chats, members, invite links, and admin rights.

GET/bot<token>/getChat→ Chat

Up-to-date information about a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.

GET/bot<token>/getChatAdministrators→ Array of ChatMember

List a chat's administrators.

GET/bot<token>/getChatMember→ ChatMember

Information about one member of a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`user_id`	Integer	Yes	Unique identifier of the target user.

GET/bot<token>/getChatMemberCount→ Integer

Number of members in a chat.

GET/bot<token>/getUserProfilePhotos→ UserProfilePhotos

A user's profile photos.

GET/bot<token>/getUserChatBoosts→ UserChatBoostsPartial support

A user's boosts in a chat.

chat_id as @username is rejected – pass the numeric id.

POST/bot<token>/setChatTitle→ True

Change the title of a group, supergroup, or channel.

POST/bot<token>/setChatDescription→ True

Change the description of a group, supergroup, or channel.

POST/bot<token>/setChatPhoto→ True

Set a new chat photo. The bot must be an administrator.

POST/bot<token>/deleteChatPhoto→ True

Remove the chat photo.

POST/bot<token>/pinChatMessage→ True

Pin a message in the chat.

POST/bot<token>/unpinChatMessage→ True

Unpin a pinned message. Without message_id the most recent pin is removed.

POST/bot<token>/unpinAllChatMessages→ True

Unpin every pinned message in the chat.

POST/bot<token>/leaveChat→ True

Make the bot leave the group, supergroup, or channel.

Moderation

Ban, restrict, and promote members. The bot needs the matching administrator right in the chat.

POST/bot<token>/banChatMember→ True

Ban a user from a group, supergroup, or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`user_id`	Integer	Yes	Unique identifier of the target user.
`revoke_messages`	Boolean	Optional	Delete every message from this user in the chat.

POST/bot<token>/unbanChatMember→ True

Lift a ban so the user can rejoin via an invite link.

POST/bot<token>/restrictChatMember→ True

Restrict what a supergroup member is allowed to do.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`user_id`	Integer	Yes	Unique identifier of the target user.
`permissions`	ChatPermissions	Yes	JSON object listing what the member may do.

POST/bot<token>/promoteChatMember→ True

Promote or demote a member by setting administrator rights.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`user_id`	Integer	Yes	Unique identifier of the target user.
`can_manage_chat`	Boolean	Optional	Grant the corresponding administrator right. Each right is a separate boolean parameter.

POST/bot<token>/setChatAdministratorCustomTitle→ True

Set a custom title for an administrator the bot promoted.

POST/bot<token>/setChatPermissions→ True

Set the default permissions for all members of a supergroup.

Invite links & join requests

POST/bot<token>/exportChatInviteLink→ String

Generate a new primary invite link, revoking the previous one.

POST/bot<token>/createChatInviteLink→ ChatInviteLink

Create an additional invite link with an optional expiry or member limit.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Unique identifier of the target chat, or @channelusername.
`name`	String	Optional	Link name, up to 32 characters.
`expire_date`	Integer	Optional	Unix time when the link expires.
`member_limit`	Integer	Optional	How many users may join with this link, 1-99999.
`creates_join_request`	Boolean	Optional	Require admin approval instead of joining directly.

POST/bot<token>/editChatInviteLink→ ChatInviteLink

Edit an invite link the bot created.

POST/bot<token>/revokeChatInviteLink→ ChatInviteLink

Revoke an invite link so it stops working.

POST/bot<token>/approveChatJoinRequest→ True

Approve a pending request to join the chat.

POST/bot<token>/declineChatJoinRequest→ True

Decline a pending request to join the chat.

Bot configuration

GET/bot<token>/getMe→ User

Basic information about the bot. A quick way to verify your token.

POST/bot<token>/setMyCommands→ TruePartial support

Set the bot's list of commands.

The chat, chat_administrators and chat_member scopes silently fall back to the default scope.

Parameter	Type	Required	Description
`commands`	Array of BotCommand	Yes	JSON array of commands, 0-100 entries.
`scope`	BotCommandScope	Optional	Where the commands apply. Only the default scope is honoured today.
`language_code`	String	Optional	Two-letter language code the commands apply to.

GET/bot<token>/getMyCommands→ Array of BotCommand

Current list of the bot's commands.

POST/bot<token>/setMyName→ True

Set the bot's name.

GET/bot<token>/getMyName→ BotName

Current bot name.

POST/bot<token>/setMyDescription→ True

Set the bot's description.

POST/bot<token>/setChatMenuButton→ TruePartial support

Change the bot's menu button in a chat.

The web_app button type is rejected with 400. Private chats only.

POST/bot<token>/logOut→ True

Log out from the cloud Bot API before moving the bot to your own server.

POST/bot<token>/deleteMyCommands→ TruePartial support

Delete the bot's command list for the given scope and language.

The chat, chat_administrators and chat_member scopes silently fall back to the default scope.

GET/bot<token>/getMyDescription→ BotDescription

Read the bot's description shown on an empty chat screen.

POST/bot<token>/setMyShortDescription→ True

Set the short description shown on the bot's profile page.

GET/bot<token>/getMyShortDescription→ BotShortDescription

Read the bot's short description.

GET/bot<token>/getChatMenuButton→ MenuButton

Read the bot's menu button for a chat, or the default one.

POST/bot<token>/setMyDefaultAdministratorRights→ True

Set the administrator rights requested when the bot is added to a chat.

GET/bot<token>/getMyDefaultAdministratorRights→ ChatAdministratorRights

Read the bot's default administrator rights.

POST/bot<token>/setUserEmojiStatus→ True

Set a user's emoji status using a custom emoji the bot may use.

POST/bot<token>/close→ TruePartial support

Close the bot instance before moving it between servers.

Accepted and answers true, but is a no-op – Reyta has no local-server model to close.

Files & stickers

GET/bot<token>/getFile→ File

Prepare a file for download and return a File with its path.

Parameter	Type	Required	Description
`file_id`	String	Yes	Identifier of the file. The response contains a file_path to download from /file/bot<token>/<file_path>.

GET/bot<token>/getStickerSet→ StickerSet

A sticker set by name.

GET/bot<token>/getCustomEmojiStickers→ Array of Sticker

Information about custom emoji stickers by id.

POST/bot<token>/createNewStickerSet→ TrueNot available yet

Create a new sticker set owned by a user.

Not implemented yet – returns 501. Creating sticker sets needs file upload, which is not wired up.

POST/bot<token>/deleteStickerFromSet→ True

Remove a sticker from a set.

POST/bot<token>/deleteStickerSet→ True

Delete a sticker set the bot created.

POST/bot<token>/setStickerSetTitle→ True

Rename a sticker set the bot created.

POST/bot<token>/setStickerPositionInSet→ True

Move a sticker to a different position in its set.

POST/bot<token>/setStickerEmojiList→ True

Replace the emoji associated with a sticker.

POST/bot<token>/setStickerKeywords→ True

Replace the search keywords of a sticker.

POST/bot<token>/setStickerMaskPosition→ True

Change where a mask sticker is placed on a face.

POST/bot<token>/uploadStickerFile→ FileNot available yet

Upload a sticker file for later use in a sticker set.