Discord Bot Moderation API

Installation

npm install discord.js
# Set environment variable PAXMOD_API_KEY with your key from the console

Example bot code

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.on('messageCreate', async (message) => {
  // Skip bots and DMs
  if (message.author.bot || !message.guild) return;

  try {
    const response = await fetch('https://www.paxmod.com/api/v1/text', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.PAXMOD_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        message: message.content,
        user_id: message.author.id,
        context_id: message.channel.id,
      }),
    });

    const result = await response.json();

    if (result.content_moderation?.flagged) {
      // Delete the message
      await message.delete();

      // Optional: send a warning
      await message.channel.send(
        `${message.author}, your message was removed: ${result.reason}`
      );

      // Optional: log to a mod channel
      const modChannel = client.channels.cache.get(process.env.MOD_CHANNEL_ID);
      if (modChannel) {
        modChannel.send(
          `Auto-moderation: ${message.author.tag} - ${result.reason}`
        );
      }
    }
  } catch (error) {
    // Fail open: if the API is unreachable, allow the message
    console.error('Paxmod API error:', error);
  }
});

client.login(process.env.DISCORD_TOKEN);

This bot requires the MESSAGE_CONTENT privileged intent. Enable it in the Discord Developer Portal under your bot's settings. Bots in 100+ servers need verification to use this intent.

Installation

pip install discord.py requests
# Set environment variable PAXMOD_API_KEY with your key from the console

Example bot code

import discord
import requests
import os

intents = discord.Intents.default()
intents.message_content = True
client = discord.Client(intents=intents)

PAXMOD_API_KEY = os.environ.get('PAXMOD_API_KEY')
MOD_CHANNEL_ID = int(os.environ.get('MOD_CHANNEL_ID', 0))

@client.event
async def on_message(message):
    # Skip bots and DMs
    if message.author.bot or not message.guild:
        return

    try:
        response = requests.post(
            'https://www.paxmod.com/api/v1/text',
            headers={
                'Authorization': f'Bearer {PAXMOD_API_KEY}',
                'Content-Type': 'application/json',
            },
            json={
                'message': message.content,
                'user_id': str(message.author.id),
                'context_id': str(message.channel.id),
            },
            timeout=3,
        )
        
        result = response.json()

        if result.get('content_moderation', {}).get('flagged'):
            # Delete the message
            await message.delete()

            # Optional: send a warning
            await message.channel.send(
                f"{message.author.mention}, your message was removed: {result['reason']}"
            )

            # Optional: log to a mod channel
            if MOD_CHANNEL_ID:
                mod_channel = client.get_channel(MOD_CHANNEL_ID)
                if mod_channel:
                    await mod_channel.send(
                        f"Auto-moderation: {message.author} - {result['reason']}"
                    )

    except Exception as error:
        # Fail open: if the API is unreachable, allow the message
        print(f'Paxmod API error: {error}')

client.run(os.environ['DISCORD_TOKEN'])

Remember to enable the MESSAGE_CONTENT privileged intent in the Discord Developer Portal. Without it, message.content will be empty.