List Categories

Returns the list of moderation categories available for your account, along with their default and configured thresholds.

Request

This endpoint takes no request body or query parameters. Authenticate with your API key.

curl https://api.getsieve.dev/v1/categories \
  -H "Authorization: Bearer mod_live_abc123..."

const response = await fetch("https://api.getsieve.dev/v1/categories", {
  headers: {
    "Authorization": "Bearer mod_live_abc123...",
  },
});

const categories = await response.json();

import requests

response = requests.get(
    "https://api.getsieve.dev/v1/categories",
    headers={"Authorization": "Bearer mod_live_abc123..."},
)

categories = response.json()

Response

Array of category objects.

Category identifier (e.g., toxicity, harassment).

Human-readable description of what the category detects.

The platform default threshold (0.0 to 1.0).

Your configured threshold. Matches default_threshold unless you have customized it.

Whether this category is active for your account.

Example Response

{
  "categories": [
    {
      "name": "toxicity",
      "description": "Generally toxic, rude, or disrespectful language.",
      "default_threshold": 0.7,
      "threshold": 0.7,
      "enabled": true
    },
    {
      "name": "harassment",
      "description": "Targeted insults, bullying, or intimidation.",
      "default_threshold": 0.7,
      "threshold": 0.7,
      "enabled": true
    },
    {
      "name": "hate_speech",
      "description": "Attacks based on race, religion, gender, orientation, or other protected attributes.",
      "default_threshold": 0.7,
      "threshold": 0.7,
      "enabled": true
    },
    {
      "name": "sexual",
      "description": "Sexually explicit or suggestive content.",
      "default_threshold": 0.8,
      "threshold": 0.8,
      "enabled": true
    },
    {
      "name": "violence",
      "description": "Graphic violence, threats, or glorification of harm.",
      "default_threshold": 0.7,
      "threshold": 0.7,
      "enabled": true
    },
    {
      "name": "self_harm",
      "description": "Content promoting or describing self-harm or suicide.",
      "default_threshold": 0.7,
      "threshold": 0.7,
      "enabled": true
    },
    {
      "name": "spam",
      "description": "Spam, scams, or unsolicited commercial content.",
      "default_threshold": 0.9,
      "threshold": 0.9,
      "enabled": true
    }
  ]
}