Reyta Bot API

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

allowed_updates filters at read time: filtered updates are not returned, but they stay in the queue and keep counting toward pending_update_count until an offset past them is confirmed.

RequestCopy

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

ResponseCopy

{
  "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"
      }
    }
  ]
}

Register an HTTPS URL to receive updates via push. Reyta delivers each update as a JSON POST.

RequestCopy

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

ResponseCopy

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

Remove the webhook and switch back to getUpdates.

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

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

The reply_to_message object carries the replied message's id and chat, not its full content — fetch it by id if you need the body. link_preview_options is not echoed back.

RequestCopy

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

ResponseCopy

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

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/sendPhoto" \
  -F chat_id=1000100 -F caption="Look" -F photo=@cat.jpg

ResponseCopy

{
  "ok": true,
  "result": {
    "message_id": 512,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "caption": "Look",
    "photo": [ { "file_id": "l8BvW8G5ZiGyZcYCX...", "file_unique_id": "k9UIku2zcCg", "width": 320, "height": 240, "file_size": 8123 } ]
  }
}

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/forwardMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42"

ResponseCopy

{
  "ok": true,
  "result": {
    "message_id": 516,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900030,
    "text": "the forwarded text"
  }
}

Copy a message without a forward header.

Implemented as a copy followed by a caption edit. If that edit fails the copy still lands, but without the new caption.

RequestCopy

curl "https://api.reyta.uz/bot<token>/copyMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42&caption=New caption"

ResponseCopy

{ "ok": true, "result": { "message_id": 517 } }

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/sendDocument" \
  -F chat_id=1000100 -F [email protected]

ResponseCopy

{
  "ok": true,
  "result": {
    "message_id": 513,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900010,
    "document": { "file_id": "qWQSGcLKbVNV1I3y...", "file_unique_id": "Ch0MHHySQBAA", "file_name": "report.pdf", "mime_type": "application/pdf", "file_size": 20481 }
  }
}

Send an MP4 video.

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

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

Send a voice message (OGG/OPUS).

Send a rounded, square video note.

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/sendMediaGroup" \
  -d chat_id=1000100 \
  -d 'media=[{"type":"photo","media":"https://reyta.uz/a.jpg","caption":"one"},{"type":"photo","media":"https://reyta.uz/b.jpg"}]'

ResponseCopy

{
  "ok": true,
  "result": [
    { "message_id": 514, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "caption": "one", "photo": [] },
    { "message_id": 515, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "photo": [] }
  ]
}

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

Send information about a venue.

Send a phone contact.

Send a native poll or quiz.

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

Send an animated emoji with a random value.

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

Send a static, animated, or video sticker.

RequestCopy

curl "https://api.reyta.uz/bot<token>/sendSticker" \
  -d "chat_id=1000100&sticker=CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA"

ResponseCopy

{
  "ok": true,
  "result": {
    "message_id": 1022,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot", "username": "Jokeformebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787863074,
    "sticker": {
      "file_id": "CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA",
      "file_unique_id": "Chxr-NpPwBAA",
      "type": "regular",
      "width": 512,
      "height": 512,
      "is_video": true,
      "emoji": "\uD83D\uDC4D",
      "file_size": 126387
    }
  }
}

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

Forward several messages at once, keeping the original author.

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.

RequestCopy

curl "https://api.reyta.uz/bot<token>/editMessageText" \
  -d "chat_id=1000100&message_id=512&text=Updated&parse_mode=HTML"

ResponseCopy

{
  "ok": true,
  "result": {
    "message_id": 512,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "text": "Updated"
  }
}

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.

Replace the media of a message.

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

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.

Move an active live location.

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

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/deleteMessage" -d "chat_id=1000100&message_id=512"

ResponseCopy

{ "ok": true, "result": true }

Delete multiple messages at once.

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.

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

Stop an active poll the bot sent.

Returns true instead of the final Poll object.

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/answerCallbackQuery" \
  -d "callback_query_id=4382bfdwdsb323b2d9&text=Saved"

ResponseCopy

{ "ok": true, "result": true }

Answer an inline query with a list of results.

Supported result types: article, photo, gif, mpeg4_gif, video, audio, voice, document, sticker, location, venue and contact - each in both the URL and the cached (*_file_id) flavour Bot API defines. Games are not supported and return 400.

RequestCopy

curl "https://api.reyta.uz/bot<token>/answerInlineQuery" \
  -d inline_query_id=1234567890 \
  -d 'results=[{"type":"article","id":"1","title":"Hello","input_message_content":{"message_text":"Hello!"}}]'

ResponseCopy

{ "ok": true, "result": true }

Up-to-date information about a chat.

Returns the full ChatFullInfo. The pinned_message object carries the pinned message's id and chat, not its body — read it by id if you need the text.

RequestCopy

curl "https://api.reyta.uz/bot<token>/getChat" -d chat_id=-1001234567890

ResponseCopy

{
  "ok": true,
  "result": {
    "id": -1001234567890,
    "type": "supergroup",
    "title": "Reyta devs",
    "username": "reytadevs",
    "description": "Server talk",
    "invite_link": "https://t.me/+abcdef",
    "member_count": 128,
    "permissions": { "can_send_messages": true, "can_send_photos": true, "can_pin_messages": false }
  }
}

List a chat's administrators.

Information about one member of a chat.

RequestCopy

curl "https://api.reyta.uz/bot<token>/getChatMember" -d "chat_id=-1001234567890&user_id=1000100"

ResponseCopy

{
  "ok": true,
  "result": {
    "status": "administrator",
    "user": { "id": 1000100, "is_bot": false, "first_name": "Johan" },
    "custom_title": "Founder"
  }
}

Number of members in a chat.

A user's profile photos.

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

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

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

Remove the chat photo.

Pin a message in the chat.

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

Unpin every pinned message in the chat.

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

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/banChatMember" \
  -d "chat_id=-1001234567890&user_id=1000100&revoke_messages=true"

ResponseCopy

{ "ok": true, "result": true }

Ban a channel that posts into a supergroup on its own behalf.

Lift a channel ban in a supergroup.

Set the group sticker set of a supergroup.

Remove the group sticker set from a supergroup.

Unpin every message in the General forum topic.

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

Restrict what a supergroup member is allowed to do.

Promote or demote a member by setting administrator rights.

Set a custom title for an administrator the bot promoted.

Set the default permissions for all members of a supergroup.

RequestCopy

curl "https://api.reyta.uz/bot<token>/setChatPermissions" \
  -d chat_id=-1001234567890 \
  -d 'permissions={"can_send_messages":true,"can_send_photos":false}'

ResponseCopy

{ "ok": true, "result": true }

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

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

Edit an invite link the bot created.

Revoke an invite link so it stops working.

Approve a pending request to join the chat.

Decline a pending request to join the chat.

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

Set the bot's list of commands.

RequestCopy

curl "https://api.reyta.uz/bot<token>/setMyCommands" \
  -d 'commands=[{"command":"start","description":"Begin"},{"command":"help","description":"How it works"}]' \
  -d 'scope={"type":"all_private_chats"}'

ResponseCopy

{ "ok": true, "result": true }

Current list of the bot's commands.

Set the bot's name.

Current bot name.

Set the bot's description.

Change the bot's menu button in a chat.

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

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

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

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

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

Read the bot's short description.

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

Reports only default or commands. A menu button of any other type reads back as default.

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

Read the bot's default administrator rights.

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

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.

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

RequestCopy

curl "https://api.reyta.uz/bot<token>/getFile" -d file_id=CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA

ResponseCopy

{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888,
    "file_path": "sticker/CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA"
  }
}

A sticker set by name.

Information about custom emoji stickers by id.

Create a new sticker set owned by a user.

The set is owned by the bot that creates it, not by user_id — Reyta stamps ownership from the API caller. needs_repainting is accepted but not stored.

RequestCopy

curl "https://api.reyta.uz/bot<token>/createNewStickerSet" \
  -F user_id=1000100 -F name=mypack_by_yourbot -F title="My pack" \
  -F 'stickers=[{"sticker":"attach://s1","format":"static","emoji_list":["🔥"]}]' \
  -F s1=@cat.webp

ResponseCopy

{ "ok": true, "result": true }

Remove a sticker from a set.

Delete a sticker set the bot created.

Rename a sticker set the bot created.

Move a sticker to a different position in its set.

Replace the emoji associated with a sticker.

Replace the search keywords of a sticker.

Change where a mask sticker is placed on a face.

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

The file is validated before it is stored: format, dimensions (one side 512px), TGS frame rate and duration, WebM codec. A rejected file returns 400 naming the rule it broke.

RequestCopy

curl "https://api.reyta.uz/bot<token>/uploadStickerFile" \
  -F user_id=1000100 -F sticker_format=static -F sticker=@cat.webp

ResponseCopy

{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888
  }
}

Add a new sticker to a set the bot created.

A sticker already in the set is rejected with 400 rather than duplicated. Only the set's owner bot may add to it.

Replace an existing sticker in a set.

The replacement is added before the old sticker is removed, so a rejected replacement leaves the set untouched.

Set the thumbnail of a sticker set.

Only a sticker already in the set can be the thumbnail; uploading a separate thumbnail image returns 400.

Set the thumbnail of a custom emoji sticker set.

Create a topic in a forum supergroup.

Edit name/icon of a forum topic.

Delete a forum topic along with its messages.

Close a forum topic so no new messages can be posted.

Reopen a closed forum topic.

Unpin every pinned message in a forum topic.

Rename the General topic of a forum.

Close the General topic of a forum.

Reopen the General topic of a forum.

Hide the General topic from the forum's topic list.

Show the General topic again.

List the stickers available as forum topic icons.

Reyta has no curated topic-icon pack. An operator can point the server at a custom emoji set; until then the method returns an empty array and clients show no custom-icon picker.