Koee Developer Docs

Welcome to the Koee developer documentation.

Developer access: Bot availability depends on the target service and the
bot's access settings. Request access and a bot token from the Koee
team at support@koee.app before integrating.
Publishing this guide does not enable Bot access for every account or app
release. Native Kit development remains a private, reviewed preview.

Koee is a private messenger. Developer APIs are intentionally narrow: Koee provides the messaging channel, identity, delivery, permissions, and quotas. Your agent or service provides the actual intelligence and business logic.

Available APIs

• Bot API single-page guide covers authentication, receiving updates, messages, attachments, buttons, and runnable starter examples.
• Kit Development guide defines the source, capability, server, platform, security, and testing contract for reviewed native Kit modules. Kit development remains a private Preview and is not open for public enrollment or self-service submission. Official Kits that appear in the app are compiled into and reviewed with that app release.

Production URLs

Bot API preview

After the Koee team provisions your bot, verify the token with getMe. Use tokens only with the service that issued them; accounts and tokens are not shared between products.

export KOEE_BOT_TOKEN="bot_xxx"

curl -sS https://ims.koee.app/bot/getMe \
  -X POST \
  -H "Authorization: Bot $KOEE_BOT_TOKEN" \
  -H "Content-Type: application/json"

Then use either Bot Gateway WebSocket for realtime updates or polling for simple deployments.

Kit development in one minute

A native Kit is a reviewed local Dart package under kits/. It implements the small KitModule contract, declares the platforms it has actually tested, and uses only host-provided capabilities through KitContext. The server catalog can narrow visibility or disable a Kit, but it cannot download code or enable a platform omitted by the compiled package.

Read the complete Kit Development guide before creating a module.