Usage Limits¶

Parapet Security has usage limits to ensure fair service for all customers.

Types of Limits¶

Monthly Alert Quota¶

Your plan determines how many alerts you can process per month.

How Alerts Are Counted¶

• Each webhook request = 1 alert
• Regardless of payload size
• Test alerts count
• Rejected requests (400 errors) don't count

Viewing Usage¶

1. Go to Settings → Account & Billing
2. See current usage and limit
3. View daily breakdown chart

What Happens at Limit¶

When you reach your monthly quota:

1. New alerts return HTTP 429
2. Alerts are queued (not lost)
3. Queued alerts process when quota resets
4. You receive an email notification

Rate Limits¶

Rate limits prevent alert floods from overwhelming the system.

*Daily limits are your monthly quota, not rate-based.

Rate Limit Response¶

When rate limited, you receive:

HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1706454600

Headers explained:

Handling Rate Limits¶

Implement exponential backoff:

import time
import requests

def send_alert(payload, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(webhook_url, json=payload, headers=headers)

        if response.status_code != 429:
            return response

        retry_after = int(response.headers.get('Retry-After', 30))
        wait_time = min(retry_after, 2 ** attempt)
        time.sleep(wait_time)

    raise Exception("Max retries exceeded")

Payload Size Limits¶

Large Payload Solutions¶

If your alerts exceed 1 MB:

1. Remove raw logs - Reference instead of include
2. Compress data - Summarize verbose fields
3. Split alerts - Send multiple smaller payloads

Service Token Limits¶

Token Best Practices¶

• Use one token per SIEM/environment
• Name tokens descriptively
• Rotate tokens periodically
• Revoke unused tokens

Data Retention¶

After retention period:

• Alerts automatically deleted
• Cannot be recovered
• Aggregated stats retained

Notification Limits¶

These limits prevent notification spam:

Exceeding notification limits:

• Excess alerts skip notification
• Still appear in dashboard
• Notification backlog sent in digest

API Limits¶

For API access (Professional+ plans):

Monitoring Your Usage¶

Dashboard Indicators¶

• Usage bar - Shows current vs. limit
• Rate indicator - Alerts per minute
• Warning banner - At 80% usage

Email Alerts¶

Automatic notifications at:

• 50% of monthly quota
• 80% of monthly quota
• 100% of monthly quota

API Check¶

Query usage programmatically:

curl https://api-us.parapetsecurity.com/v1/usage \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response:

{
  "period_start": "2026-01-01T00:00:00Z",
  "period_end": "2026-02-01T00:00:00Z",
  "alerts_used": 342,
  "alerts_limit": 500,
  "rate_limit_per_minute": 50,
  "current_rate": 12
}

Increasing Limits¶

Upgrade Plan¶

Higher plans include higher limits:

Purchase Overages¶

Professional plan can purchase additional alerts:

• 1,000 alerts: $30
• 5,000 alerts: $100

Need More?¶

For custom requirements beyond Team plan limits, contact sales@parapetsecurity.com.

Fair Use Policy¶

All plans are subject to fair use:

• No automated abuse or DoS
• No sharing tokens across organizations
• No circumventing limits
• Violations may result in suspension

See Terms of Service for details.