Troubleshooting
4 min read

API Authentication Issues

Resolve API key and authentication errors

API Authentication Issues

Troubleshoot API authentication problems.

Error: "Invalid API Key"

Cause: The API key is incorrect or malformed

Fix:

  • Go to Settings → API Keys
  • Copy the full API key (starts with "sos_")
  • Ensure no extra spaces
  • Use in the X-API-Key header

    • Error: "API Key Expired"

    Cause: Key has passed its expiration date

    Fix:

  • Go to Settings → API Keys
  • Check the expiration date
  • Rotate the key or create a new one
  • Update your integration with new key

    • Error: "Rate Limit Exceeded"

    Cause: Too many requests in time window

    Details:

  • 60 requests per minute (default)
  • 1,000 requests per day

    • Fix:

  • Implement exponential backoff
  • Cache responses where possible
  • Contact support for limit increase

    • Error: "Unauthorized"

    Cause: Missing or incorrect authorization

    Fix:

  • Ensure header is "X-API-Key" (not "Authorization")
  • Check the key is active
  • Verify account is in good standing

    • Testing Your Key

    Use this curl command:

    curl -X GET "https://api.outreign.io/v1/leads" \
  -H "X-API-Key: YOUR_API_KEY"

    Security Best Practices

  • Never expose keys in client-side code
  • Rotate keys regularly
  • Use environment variables
  • Monitor usage for anomalies

    • Was this article helpful?

    Related Articles

    API Documentation Overview

    Getting started with the OutReign API

    Rate Limit Exceeded Solutions

    Handle API rate limiting gracefully

    APIauthenticationerrorskeys