Authentication

All API requests require authentication using your API key.

Getting Your API Key

1. Sign in to your reGOTCHA account
2. Navigate to Console → API Keys
3. Click Create API Key
4. Give your key a descriptive name (e.g., "Production", "Development")
5. Copy and securely store your API key

Using Your API Key

Include your API key in the request body as clientKey:

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    // task details
  }
}

Multiple API Keys

You can create multiple API keys for different purposes:

• Development - For local testing
• Staging - For pre-production testing
• Production - For live applications

Each key shares your account's credit balance but tracks usage separately, making it easy to monitor usage per environment.

Revoking Keys

If you suspect a key has been compromised:

1. Go to Console → API Keys
2. Find the compromised key
3. Click the Delete button
4. Create a new key and update your applications

Rate Limits

API requests are rate-limited per API key to ensure fair usage:

• 30 requests per minute per API key

If you exceed this limit, you'll receive an ERROR_RATE_LIMIT error response with a retry_after value indicating when you can retry.

{
  "errorId": 1,
  "errorCode": "ERROR_RATE_LIMIT",
  "errorDescription": "Rate limit exceeded. Retry after 15 seconds"
}

Resource Limits

To ensure fair usage, the following resource limits apply:

Need higher limits? Contact us to discuss enterprise plans.