Skip to main content
Watchdog is DeepCurrent’s AI moderation service. Connect your community channel and Watchdog monitors it continuously — filtering spam, enforcing rules, and surfacing audit logs so you can see what’s happening without babysitting every message.

​
Supported channels

  • telegram
  • discord
  • reddit
  • x
  • crisp

​
Provisioning a community

Provisioning a Watchdog community costs 500 credits and renews automatically every 30 days at the same rate. Make sure you have sufficient credits before provisioning.
Send a POST request to provision a new community: 
curl -X POST https://api.deepcurrent.app/api/v1/integrations/watchdog/communities \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "DeepCurrent Official",
    "project_name": "DeepCurrent",
    "type": "telegram",
    "whitelisted_external_role_ids": ["admin", "moderator"],
    "whitelisted_usernames": ["@team_alice", "@team_bob"],
    "should_send_welcome_messages": true,
    "welcome_message": "Welcome to the DeepCurrent community! Please read the rules pinned above.",
    "alert_channel_message_template": "⚠️ Moderation action taken: {action} on {username}"
  }'

​
Request fields

FieldRequiredDescription
nameYesDisplay name for this community entry
project_nameYesYour project or brand name
typeYesChannel type: telegram, discord, reddit, x, or crisp
whitelisted_external_role_idsNoRole IDs exempt from moderation actions
whitelisted_usernamesNoSpecific usernames exempt from moderation actions
should_send_welcome_messagesNoWhether to send a welcome message to new members
welcome_messageNoThe welcome message text
alert_channel_message_templateNoTemplate for moderation alert notifications

​
Response

{
  "id": "3fa85f64-...",
  "watchdog_id": "wdg_abc123",
  "activation_token": "act_xyz...",
  "name": "DeepCurrent Official",
  "project_name": "DeepCurrent",
  "community_type": "telegram",
  "credits_charged": 500,
  "status": "connected",
  "monthly_credit_cost": 500,
  "next_billing_at": "2025-05-08T12:00:00Z",
  "auto_renew": true,
  "created_at": "2025-04-08T12:00:00Z"
}
If status is pending_activation, use the activation_token to complete setup in your channel platform.

​
Auto-renewal

Watchdog communities renew every 30 days automatically. The renewal amount matches monthly_credit_cost shown in the provisioning response. To stop auto-renewal without cancelling immediately, toggle it off: 
curl -X POST https://api.deepcurrent.app/api/v1/integrations/watchdog/communities/COMMUNITY_ID/auto-renew \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "auto_renew": false }'

​
Management endpoints

​
Check status

Get the current connection state, live metrics, and the last 25 audit log entries: 
curl "https://api.deepcurrent.app/api/v1/integrations/watchdog/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
Add ?include_logs=50 to retrieve more audit log entries (up to 100).

​
List communities

curl "https://api.deepcurrent.app/api/v1/integrations/watchdog/communities" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Update settings

Update name, whitelist, welcome message, or alert template for an existing community: 
curl -X PUT https://api.deepcurrent.app/api/v1/integrations/watchdog/communities/COMMUNITY_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "DeepCurrent Official",
    "project_name": "DeepCurrent",
    "type": "telegram",
    "should_send_welcome_messages": false
  }'

​
Trigger a manual sync

Force an immediate metrics and status refresh: 
curl -X POST https://api.deepcurrent.app/api/v1/integrations/watchdog/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "community_id": "COMMUNITY_ID" }'
The response returns the updated WatchdogStatus object including fresh metrics and recent audit logs.

​
Cancel a community

Cancelling removes the community and stops future billing. This action cannot be undone. 
curl -X DELETE https://api.deepcurrent.app/api/v1/integrations/watchdog/communities/COMMUNITY_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
A successful delete returns HTTP 204 No Content.

​
Endpoint summary

MethodPathDescription
POST/api/v1/integrations/watchdog/communitiesProvision a new community
GET/api/v1/integrations/watchdog/communitiesList your communities
GET/api/v1/integrations/watchdog/communities/{id}Get a single community
PUT/api/v1/integrations/watchdog/communities/{id}Update community settings
POST/api/v1/integrations/watchdog/communities/{id}/auto-renewToggle auto-renewal
DELETE/api/v1/integrations/watchdog/communities/{id}Cancel and remove
GET/api/v1/integrations/watchdog/statusCheck status, metrics, and audit logs
POST/api/v1/integrations/watchdog/syncTrigger a manual sync