The elevated Telegram API lets trusted external integrators poll SuperIntern
for the Telegram messages our bot has seen in your agent's groups, and list
the groups the bot is currently in. It is a server-to-server HTTP/JSON feed
secured by a Bearer API key.
It is separate from the Beta Chat-Agent API
Both flows use the same Authorization: Bearer sk_live_... header, but the
Partner API additionally requires an Elevated permission level on the
key.
| Environment | Base URL |
|---|---|
| Production | https://api.superintern.ai |
| Test | https://test-api.superintern.ai |
All endpoints in this doc are under /data/telegram-partner/.
Every request must include:
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
| Value | Name | Access |
|---|---|---|
0 |
Normal | Beta Chat-Agent API only. |
1 |
Elevated (a.k.a. "All") | Beta Chat-Agent API plus every endpoint in this doc. |
A Normal key calling any Partner endpoint receives HTTP 403 Forbidden.
Elevated keys can only be created by a team admin. In the SuperIntern admin