Skip to content
Preview: The API is still being rolled out and details may change before launch. Follow progress in the changelog.

Changelog

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.

  • A new API at https://api.sukson.dev/v1, where me is 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_token in every message event: single use, valid for 60 seconds.
  • Up to 5 messages per request.
  • One error format, {message, code, details}, plus X-Request-Id and X-RateLimit-* headers.
  • The webhook signature is unchanged (X-Sukson-Signature: v1=…).