Preview: The API is still being rolled out and details may change before launch. Follow progress in the changelog.
Changelog
Coming next
Section titled “Coming next”| Phase | What |
|---|---|
| Chats | Chat details, members, the bot leaving a chat, moderation (delete messages, kick, ban) when the chat owner grants it, and the join, leave, memberJoined, memberLeft events |
| Media | POST /v1/uploads, GET /v1/messages/{message_id}/content, and image, sticker, video, audio, file messages |
| Buttons and cards | template and quickReply messages with the postback event |
| Old API retired | /bot-api/* on api.sukson.com answers 410 with a link to these docs |
Order and details may change.
2026-11 — v1 (Preview)
Section titled “2026-11 — v1 (Preview)”- A new API at
https://api.sukson.dev/v1, wheremeis the bot that owns the token. - Endpoints:
me, quota and usage, webhook (get, set, delete, test), commands, the bot’s chats, and sending, editing and deleting messages. - A
reply_tokenin everymessageevent: single use, valid for 60 seconds. - Up to 5 messages per request.
- One error format,
{message, code, details}, plusX-Request-IdandX-RateLimit-*headers. - The webhook signature is unchanged (
X-Sukson-Signature: v1=…).