Rate Limiting

The Aikido Public API implements rate limiting to ensure fair usage and maintain service quality for all users.

Default Rate Limits

• Standard Rate Limit: 20 API calls per minute per workspace
• Enhanced Rate Limit: 50 API calls per minute per workspace (Only available on request)

How Rate Limiting Works

Rate limiting is enforced on a per-workspace basis using the following criteria:

• Workspace ID: Each workspace has its own rate limit counter
• Time Window: Rolling 1-minute window (sliding window)

Rate Limit Enforcement

When you exceed the rate limit:

1. HTTP Status: 429 Too Many Requests
2. Response Body: Error message indicating the limit exceeded
3. Retry-After Header: Contains the number of seconds to wait before retrying

Example Error Response

{
  "error": "You have reached the maximum number of calls per minute. (20 calls per minute)"
}

The Retry-After header will indicate when you can make your next request.

Best Practices

1. Implement Exponential Backoff

When you receive a 429 response, wait for the time specified in the Retry-After header before retrying.

2. Monitor Your Usage

Track your API call frequency to stay within limits and avoid rate limiting.

3. Bulk Requests When Possible

Combine multiple operations into single API calls where the API supports it.

4. Handle Rate Limits Gracefully

Implement proper error handling for 429 responses in your application.