Download OpenAPI specification:
APIs for managing communities and fetching statistics in Watchdog. If you need an API key, contact support@watchdog.chat with your use case.
name required | string |
project_name required | string |
external_id required | string External community identifier (e.g. Telegram chat ID). |
type required | string Value: "telegram" |
bot_token | string or null Optional bot token for custom branding |
whitelisted_usernames | Array of strings Optional list of usernames allowed to bypass moderation |
should_send_welcome_messages | boolean |
welcome_message | string |
should_process_messages_from_admins | boolean |
alert_channel_message_template | string |
{- "name": "Dogecoin Dealers Group",
- "project_name": "Dogecoin",
- "external_id": "-1001234567891",
- "type": "telegram"
}
{- "code": "ok",
- "message": null,
- "data": null
}
id required | string Example: 2910799f-2cd4-4bac-8018-5757bb12e9f0 |
name required | string |
project_name required | string |
external_id required | string External community identifier (e.g. Telegram chat ID). |
type required | string Value: "telegram" |
bot_token | string or null Optional bot token for custom branding |
whitelisted_usernames | Array of strings Optional list of usernames allowed to bypass moderation |
should_send_welcome_messages | boolean |
welcome_message | string |
should_process_messages_from_admins | boolean |
alert_channel_message_template | string |
{- "name": "Bitcoin Ballers Group",
- "external_id": "-1001234567890",
- "type": "telegram",
- "bot_token": "79420012345:AAHxb...<rest>",
- "whitelisted_usernames": [
- "SatoshiNakamoto",
- "DonaldTrump",
- "BillGates"
], - "should_send_welcome_messages": true,
- "welcome_message": "Welcome to Bitcoin Ballers! We're glad you're here 🎉",
- "should_process_messages_from_admins": true,
- "alert_channel_message_template": "**Alert:** ${author_username} may have violated a rule."
}
{- "code": "ok",
- "message": null,
- "data": null
}
community_id required | string Example: 2910799f-2cd4-4bac-8018-5757bb12e9f0 |
start_date | string <date> Example: start_date=2025-08-28 |
end_date | string <date> Example: end_date=2025-08-29 |
{- "code": "ok",
- "message": "Successfully retrieved community statistics.",
- "data": {
- "num_messages_analyzed": 5,
- "num_messages_moderated": 1,
- "num_questions_asked": 2,
- "num_questions_answered": 1
}
}