SoumaSouma
⌘K
Sign in

API Keys

API keys authenticate your requests to the Souma API. Manage them from Dashboard > Settings > API Keys.

Generating a key

  1. Navigate to your dashboard
  2. Go to Settings > API Keys
  3. Click Generate new key
  4. Copy and securely store your key

Important: API keys are shown only once at creation. Store them securely before closing the dialog.

Key permissions

PermissionDescription
validateSubmit content for validation
readRead validation results and stats
adminFull account access including key management

Usage monitoring

Track key usage directly in the dashboard:

  • Requests per day/week/month
  • Error rates and response times
  • Content types validated
  • Flag frequency and severity distribution

Revoking a key

If a key is compromised:

  1. Go to Settings > API Keys
  2. Find the compromised key
  3. Click Revoke
  4. Generate a new key and update your applications
PreviousOverview